Re: Documentation in book length - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: Documentation in book length
Date
Msg-id Pine.LNX.4.44.0301031948540.8249-100000@localhost.localdomain
Whole thread Raw
In response to Re: Documentation in book length  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
Tom Lane writes:

> BTW, the Red Hat RHDB group has spent a fair amount of time rethinking
> the overall organization of the docs and trying to organize 'em in a
> more logical order.  They'd like to contribute that work back so they
> don't have to maintain a variant version of the docs.  Is this a good
> time to think about looking over what they've done?

Yes, we shall use them as an example of how not to do it.

I spend quite some time today to analyze their documentation arrangement,
but it doesn't make sense to me.  There are a couple of obvious
rearrangements and a couple of things we could think about if they were
briefly explained, but overall it looks pretty confused, to say it nicely.

--
Peter Eisentraut   peter_e@gmx.net


pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: status of 7.3 docs?
Next
From: Tom Lane
Date:
Subject: Re: Documentation in book length