public inbox for [email protected]  

help / color / mirror / Atom feed

From: Josh Berkus <[email protected]>
To: Peter Eisentraut <[email protected]>
To: [email protected]
Subject: Re: PostgreSQL.conf / runtime docs
Date: Mon, 9 Aug 2004 13:53:59 -0700
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

Peter,

> If you plan to do major outline reorganizations, I suggest that you do
> them somewhat sooner than a few days before release, because there is
> also a release management effort involved in the documentation.  But
> you can always plug in your latest measurements any time.

No massive re-org, we did that last version.

No, here's what I want to do:

1) add a new section at the top of the docs describing the most common options 
that people want to set on a new installation.
2) Add notes to each item about how to decide what to set it at.
3) Add label/values for:
	Default Value:
	Set At: (when you can change it)
	(this latter information is there but buried in the text; it would be better 	
	put on a seperate line)
4) add notes regarding version changes (like that work_mem used to be 
sort_mem, and that add_missing_from will default to "false" next version)

Your recommendations on tagging stuff are highly welcome; I'm still 
uncomfortable with SGML.

-- 
Josh Berkus
Aglio Database Solutions
San Francisco

view thread (5+ messages)

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]
  Subject: Re: PostgreSQL.conf / runtime 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