Re: Improve initdb and pg_controldata manual pages

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