From: Peter Eisentraut <peter_e@gmx.net>
To: pgsql-docs@postgresql.org
Subject: Re: order of entries in admin docs
Date: Wed, 7 May 2008 23:58:22 +0200
User-Agent: KMail/1.9.9
Cc: Bruce Momjian <bruce@momjian.us>,
	Alvaro Herrera <alvherre@commandprompt.com>,
	Scott Marlowe <scott.marlowe@gmail.com>, Tom Lane <tgl@sss.pgh.pa.us>
References: <200805072134.m47LYlY16758@momjian.us>
In-Reply-To: <200805072134.m47LYlY16758@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200805072358.23996.peter_e@gmx.net>

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.