From: Bruce Momjian <bruce@momjian.us>
Message-Id: <201103091736.p29Ha1006541@momjian.us>
Subject: Re: Improve initdb and pg_controldata manual pages
In-Reply-To: <AANLkTinSpRATNbdLnZxHX+wVniuXU-PUvyMLxr+7_ab2@mail.gmail.com>
To: Robert Haas <robertmhaas@gmail.com>
Date: Wed, 9 Mar 2011 12:36:01 -0500 (EST)
CC: Tom Lane <tgl@sss.pgh.pa.us>,
	PostgreSQL-documentation <pgsql-docs@postgresql.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"

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. +