From: Josh Berkus <josh@agliodbs.com>
Organization: Aglio Database Solutions
To: Neil Conway <neilc@samurai.com>
Subject: Re: Documentation of server configuration
Date: Mon, 15 Nov 2004 10:16:53 -0800
User-Agent: KMail/1.6.2
Cc: Simon Riggs <simon@2ndquadrant.com>,
	Peter Eisentraut <peter_e@gmx.net>, pgsql-docs@postgresql.org
References: <200411132120.51294.peter_e@gmx.net>
	<1100449519.2950.1123.camel@localhost.localdomain>
	<1100493852.23420.33.camel@localhost.localdomain>
In-Reply-To: <1100493852.23420.33.camel@localhost.localdomain>
MIME-Version: 1.0
Content-Disposition: inline
Content-Type: text/plain;
  charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <200411151016.53648.josh@agliodbs.com>

Neil,

> I agree that this section is frequently accessed. Given that, I think it
> is somewhat difficult to find -- we've all memorized that it is in the
> "Server Run-time Environment" chapter, but I don't think that's the
> first place most people would look. What do people think about
> separating the configuration section out to be a new top-level chapter?

I'd be up for that.   The trick will be getting it done before 8.0 ... 
although if we're going into another beta, maybe time isn't precious yet.

Actually, what I'd see is:

1) a section explaining the most frequently modified options, and links;
2) a section grouping options by general purpose (like our current 
categories), with links;
3) a dictionary of config options, which personally I would prefer to be one 
per page like the SQL commands.

If we were to do the above, then re-ordering the "dictionary" to pure 
alphabetical would make perfect sense.

-- 
Josh Berkus
Aglio Database Solutions
San Francisco