Re: order of entries in admin docs - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: order of entries in admin docs
Date
Msg-id 200805072134.m47LYlY16758@momjian.us
Whole thread Raw
In response to Re: order of entries in admin docs  (Alvaro Herrera <alvherre@commandprompt.com>)
Responses Re: order of entries in admin docs  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
Alvaro Herrera wrote:
> > > 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.

Yea, that's certainly possible, though right now we pretty much have
_all_ the information about each configuration value in one place.  We
would lose that.  Looking at the connection postgresql.conf docs:

    http://developer.postgresql.org/pgdocs/postgres/runtime-config-connection.html

There isn't much additional text except a description of each item.

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

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

pgsql-docs by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: order of entries in admin docs
Next
From: Peter Eisentraut
Date:
Subject: Re: order of entries in admin docs