Re: order of entries in admin docs - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: order of entries in admin docs
Date
Msg-id 200805072358.23996.peter_e@gmx.net
Whole thread Raw
In response to Re: order of entries in admin docs  (Bruce Momjian <bruce@momjian.us>)
Responses Re: order of entries in admin docs  (Alvaro Herrera <alvherre@commandprompt.com>)
Re: order of entries in admin docs  ("Ian Barwick" <barwick@gmail.com>)
List pgsql-docs
Bruce Momjian wrote:
> There isn't much additional text except a description of each item.

That's the way it should be: Each parameter explains what it does.  There can
be more extensive documentation about how they all fit together elsewhere.

What I would like to see is getting rid of the sections the parameters are
grouped in and put them all in alphabetical order.  I find the current
arrangement completely unusable; nine times out of ten I cannot find the
right section.  The topical grouping of the options would be the job of the
more extensive documentation elsewhere I mentioned above.

I think Postfix has arranged this nicely:
http://www.postfix.org/documentation.html -- You have various sections
explaining how to configure for various jobs, and one big list of all
parameters explained.

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: order of entries in admin docs
Next
From: Alvaro Herrera
Date:
Subject: Re: order of entries in admin docs