| From: | Peter Eisentraut <peter_e(at)gmx(dot)net> |
|---|---|
| To: | pgsql-docs(at)postgresql(dot)org |
| Cc: | 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-07 21:58:22 |
| Message-ID: | 200805072358.23996.peter_e@gmx.net |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs |
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.
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alvaro Herrera | 2008-05-07 22:17:25 | Re: order of entries in admin docs |
| Previous Message | Bruce Momjian | 2008-05-07 21:34:47 | Re: order of entries in admin docs |