Re: [HACKERS] Contrib modules documentation online
- From: Andrew Dunstan <andrew(at)dunslane(dot)net>
- To: Albert Cervera i Areny <albert(at)nan-tic(dot)com>
- Cc: Josh Berkus <josh(at)agliodbs(dot)com>, pgsql-hackers(at)postgresql(dot)org, pgsql-docs(at)postgresql(dot)org
- Subject: Re: [HACKERS] Contrib modules documentation online
- Date: Wed, 29 Aug 2007 18:52:47 -0400
- Message-id: <46D5F8BF.30703@dunslane.net> <text/plain>
Albert Cervera i Areny wrote:
I'm very strongly in favor of having this documentation. However, I think
it might make sense to put "Contrib Modules" as a section under either
"Reference" or "Appendices". Also, I don't think it's necessary to make
each command option a separate subchapter, but I can see how that would be
hard to avoid in an automated system.
It's not an automated system, README files have different structures so it's
all manual work. That's why I asked how you think it should be organized.
Anyone else thinks we should put it in Reference or Appendixes?
I would far rather have a new top level heading. Something like
"Standard Modules and Tools". (Please avoid the use of the word
"contrib"). If not, than as a sub-chapter of "References". I don't think
it belongs in the Appendixes.
cheers
andrew
Home |
Main Index |
Thread Index