From: Bruce Momjian <bruce@momjian.us>
To: Robert Haas <robertmhaas@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: Improve initdb and pg_controldata manual pages
Date: Wed, 9 Mar 2011 12:36:01 -0500 (EST)
Message-ID: <201103091736.p29Ha1006541@momjian.us> (raw)
In-Reply-To: <AANLkTinSpRATNbdLnZxHX+wVniuXU-PUvyMLxr+7_ab2@mail.gmail.com>
Robert Haas wrote:
> On Wed, Mar 9, 2011 at 11:08 AM, Bruce Momjian <bruce@momjian.us> wrote:
> >> Hard to say. ?We have the problem that our docs were made by a lot of
> >> people over a long period of time, so inconsistencies are a fact of
> >> life. ?"Pro" documentation might be more consistent if it's written by a
> >> smaller group of people over a shorter period of time...
> >
> > We probably have higher quality but lower consistency.
>
> Isn't consistency part of quality? I think on the whole that our docs
> are excellent in both quality and consistency. There are things that
> I'm not happy about, but this particular issue seems like the sort of
> thing that's not really worth spending effort on. I think the
> portions of our docs that could still use some work are the newer
> portions, such as the Hot Standby docs, which still feel a little
> rough compared to some other places - sort of a laundry list of things
> that will and won't work (UUID generators?). I'd rather see us invest
> time in general copy editing than spend a lot of time creating an
> unnecessary and possibly confusing consistency with regards to
> something like this.
Well, new docs will get their regular run-over and should look fine
eventually.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
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: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, robertmhaas@gmail.com, tgl@sss.pgh.pa.us
Subject: Re: Improve initdb and pg_controldata manual pages
In-Reply-To: <201103091736.p29Ha1006541@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox