public inbox for [email protected]  

help / color / mirror / Atom feed

From: Peter Eisentraut <[email protected]>
To: [email protected]
Cc: Bruce Momjian <[email protected]>
Cc: Alvaro Herrera <[email protected]>
Cc: Scott Marlowe <[email protected]>
Cc: Tom Lane <[email protected]>
Subject: Re: order of entries in admin docs
Date: Wed, 7 May 2008 23:58:22 +0200
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

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.

view thread (17+ messages)  latest in thread

reply

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: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: order of entries in admin docs
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox