Re: Documentation needs significant improvement

Chris Johnson <chris@chaska.com> writes:
> I just wasted 20 minutes or so trying to re-figure out how the heck to
> create the first user.  Frankly, the documentation between the step of
> installing the binaries and the step of doing useful stuff with the
> database sucks.

Criticism in the form of patches would be the most helpful ;-).
I hear your pain, but it's not clear to me exactly what to fix where.
For example:

> * The web formatting of said documentation is hosed.  I'm guessing it's
> a result of some conversion process from a former web layout.  Some
> pages flow into resized windows just fine, as all good HTML documents
> should.  Others have pre-formatted monospace-font lines with missing
> line breaks resulting in ridiculously wide pages which have to be
> scrolled horizontally -- which makes them near unusable.

I use the HTML docs all the time, and it's been awhile since I saw any
pages that rendered that badly.  *Exactly which* pages are you
complaining about?  What browser are you looking at them with?

            regards, tom lane