From: Andrew Dunstan <andrew@dunslane.net>
To: Albert Cervera i Areny <albert@nan-tic.com>
Cc: Josh Berkus <josh@agliodbs.com>
Cc: pgsql-hackers@postgresql.org
Cc: pgsql-docs@postgresql.org
Subject: Re: [HACKERS] Contrib modules documentation online
Date: Wed, 29 Aug 2007 18:52:47 -0400
Message-ID: <46D5F8BF.30703@dunslane.net> (raw)
In-Reply-To: <200708300037.31851.albert@nan-tic.com>
References: <200708290157.07968.albert@nan-tic.com>
<200708291009.07942.josh@agliodbs.com>
<200708300037.31851.albert@nan-tic.com>
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: andrew@dunslane.net, albert@nan-tic.com, josh@agliodbs.com, pgsql-hackers@postgresql.org
Subject: Re: [HACKERS] Contrib modules documentation online
In-Reply-To: <46D5F8BF.30703@dunslane.net>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox