Re: Doc reference of contrib modules
От | Bruce Momjian |
---|---|
Тема | Re: Doc reference of contrib modules |
Дата | |
Msg-id | 201101250333.p0P3X4d19935@momjian.us обсуждение исходный текст |
Ответ на | Re: Doc reference of contrib modules (Tom Lane <tgl@sss.pgh.pa.us>) |
Ответы |
Re: Doc reference of contrib modules
|
Список | pgsql-docs |
[ repost with compressed diff] Tom Lane wrote: > Bruce Momjian <bruce@momjian.us> writes: > > Now that our /contrib documentation is in our SGML manual, I want to > > update our docs to link to the actual contrib module documentation, > > rather than just referencing contrib/module_name. We used to have to do > > that when we only had READMEs, but now we can do better. > > > Patch attached, and I have a github branch of this too: > > This proposed patch seems quite inconsistent. You have removed the term > "contrib" in some places and not others. I'm fine with just referring > to stuff as "the so-and-so module" without use of the word "contrib", > but if that's what we're going to do then all the references should look > like that. OK, I found a few more places; new patch attached. I also updated github: https://github.com/bmomjian/postgres/compare/master...contrib_links > Also, I see some places where you removed the word contrib *without* > turning the reference into a link. I think that's a seriously bad idea, > since it leaves the reader with no hint of where to look in our Well, the only place I did that was with tsearch2, and I had already linked to it in the paragraph above so it seemed duplicative to do it again. I did call it "module". You can see the result here: http://momjian.us/tmp/pgsql/textsearch-migration.html Suggestions? -- Bruce Momjian <bruce@momjian.us> http://momjian.us EnterpriseDB http://enterprisedb.com + It's impossible for everything to be true. +
В списке pgsql-docs по дате отправления: