Re: [HACKERS] Contrib modules documentation online

Andrew Dunstan <andrew@dunslane.net>

From: Andrew Dunstan <andrew@dunslane.net>
To: Albert Cervera i Areny <albert@nan-tic.com>
Cc: Josh Berkus <josh@agliodbs.com>, pgsql-hackers@postgresql.org, pgsql-docs@postgresql.org
Date: 2007-08-29T22:52:47Z
Lists: pgsql-hackers

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