Re: order of entries in admin docs

From: "Ian Barwick" <barwick(at)gmail(dot)com>
To: "Peter Eisentraut" <peter_e(at)gmx(dot)net>
Cc: pgsql-docs(at)postgresql(dot)org, "Bruce Momjian" <bruce(at)momjian(dot)us>, "Alvaro Herrera" <alvherre(at)commandprompt(dot)com>, "Scott Marlowe" <scott(dot)marlowe(at)gmail(dot)com>, "Tom Lane" <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Subject: Re: order of entries in admin docs
Date: 2008-05-09 01:28:04
Message-ID: 1d581afe0805081828m1374f54yd96a75c06fbf618b@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

2008/5/8 Peter Eisentraut <peter_e(at)gmx(dot)net>:
> Bruce Momjian wrote:
>> There isn't much additional text except a description of each item.
>
> That's the way it should be: Each parameter explains what it does. There can
> be more extensive documentation about how they all fit together elsewhere.
>
> What I would like to see is getting rid of the sections the parameters are
> grouped in and put them all in alphabetical order. I find the current
> arrangement completely unusable; nine times out of ten I cannot find the
> right section. The topical grouping of the options would be the job of the
> more extensive documentation elsewhere I mentioned above.
>
> I think Postfix has arranged this nicely:
> http://www.postfix.org/documentation.html -- You have various sections
> explaining how to configure for various jobs, and one big list of all
> parameters explained.
>
> --
> Sent via pgsql-docs mailing list (pgsql-docs(at)postgresql(dot)org)
> To make changes to your subscription:
> http://www.postgresql.org/mailpref/pgsql-docs
>

--
http://sql-info.de/index.html

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Ian Barwick 2008-05-09 01:29:41 Re: order of entries in admin docs
Previous Message Alvaro Herrera 2008-05-07 22:17:25 Re: order of entries in admin docs