From: | Peter Eisentraut <peter_e(at)gmx(dot)net> |
---|---|
To: | pgsql-docs(at)postgresql(dot)org |
Subject: | Documentation of server configuration |
Date: | 2004-11-13 20:20:51 |
Message-ID: | 200411132120.51294.peter_e@gmx.net |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-general |
I've just spent a day working through the current set of server
configuration parameters, and I think that the documentation at
<http://developer.postgresql.org/docs/postgres/runtime-config.html> has
reached its peak of unusability. I haven't been able to find a single
parameter all day except by using a text search over the file.
A couple of obvious faults:
- There are too many sections.
- The sections don't have any obvious order.
- The subsections don't have any obvious order.
- The lists of individual parameters inside the sections don't have any
order.
- If a parameter has a list of possible values, the values are not
listed in a consistent order.
I have made an attempt and reformatted the whole section into one big
alphabetical list, and while that has obvious drawbacks, I feel that
it's already much more usable than what we have now.
Other ideas?
--
Peter Eisentraut
http://developer.postgresql.org/~petere/
From | Date | Subject | |
---|---|---|---|
Next Message | Alvaro Herrera | 2004-11-13 20:49:47 | Re: Documentation of server configuration |
Previous Message | Peter Eisentraut | 2004-11-10 16:21:17 | New DocBook DSSSL version |
From | Date | Subject | |
---|---|---|---|
Next Message | Max | 2004-11-13 20:37:53 | Re: List of postgresql rogue groups (was Re: Important Info on comp.databases.postgresql.general) |
Previous Message | Brian | 2004-11-13 18:20:59 | Spam notice |