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: 2007-08-29 22:52:47
Message-ID: 46D5F8BF.30703@dunslane.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs 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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Guillaume Lelarge 2007-08-30 09:31:58 Re: [HACKERS] Contrib modules documentation online
Previous Message Albert Cervera i Areny 2007-08-29 22:37:31 Re: [HACKERS] Contrib modules documentation online

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2007-08-29 23:05:26 Re: reindexdb hangs
Previous Message Tom Lane 2007-08-29 22:45:57 Re: text search function renaming