From: Bruce Momjian <bruce@momjian.us>
Message-Id: <200805071936.m47JasM01013@momjian.us>
Subject: Re: order of entries in admin docs
In-Reply-To: <20080507192717.GO20150@alvh.no-ip.org>
To: Alvaro Herrera <alvherre@commandprompt.com>
Date: Wed, 7 May 2008 15:36:54 -0400 (EDT)
CC: Scott Marlowe <scott.marlowe@gmail.com>, Tom Lane <tgl@sss.pgh.pa.us>,
	pgsql-docs@postgresql.org
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"

Alvaro Herrera wrote:
> Bruce Momjian escribi?:
> > Scott Marlowe wrote:
> 
> > > Well, if you say so.  It seems like a natural part of it to me, but
> > > the modifications required to move things like that are pretty big,
> > > and I really don't feel comfortable enough in sgml to get it right.
> > 
> > Right now we have all postgresql.conf documentation in the same chapter.
> > To move it would split that up, which I think is confusing.
> 
> Perhaps it would be better to have prose explaining all the stuff
> structured like Scott proposes, and make the postgresql.conf be just a
> reference linking to that.  I don't think making postgresql.conf be the
> primary documentation is very nice.

So you are suggesting splitting out the postgresql.conf content into its
relevant sections and just linking to it?  That would work.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +