public inbox for [email protected]  

help / color / mirror / Atom feed

From: Alvaro Herrera <[email protected]>
To: Bruce Momjian <[email protected]>
Cc: Scott Marlowe <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: [email protected]
Subject: Re: order of entries in admin docs
Date: Wed, 7 May 2008 17:02:11 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

Bruce Momjian escribió:
> 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.

Yes, or something like that.  I don't think leaving _just_ the links on
the postgresql.conf would be enough.  But a comprehensive, verbose
explanation should be elsewhere; a short blurb and the link would remain
on the postgresql.conf reference.

-- 
Alvaro Herrera                                http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.

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]
  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