Re: Improve initdb and pg_controldata manual pages

Robert Haas wrote:
> On Wed, Mar 9, 2011 at 11:08 AM, Bruce Momjian <bruce(at)momjian(dot)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(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +