Re: Contrib modules documentation online - Mailing list pgsql-hackers

From Andrew Dunstan
Subject Re: Contrib modules documentation online
Date
Msg-id 46D5F8BF.30703@dunslane.net
Whole thread Raw
In response to Re: Contrib modules documentation online  (Albert Cervera i Areny <albert@nan-tic.com>)
Responses Re: [DOCS] Contrib modules documentation online  (Guillaume Lelarge <guillaume@lelarge.info>)
List 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



pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: text search function renaming
Next
From: Tom Lane
Date:
Subject: Re: [ADMIN] reindexdb hangs