Re: [DOCS] Doc fixes and improvements

Joshua D. Drake wrote:
> On Fri, 2010-09-10 at 21:11 +0100, Thom Brown wrote:
> > On 10 September 2010 21:05, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> > > Magnus Hagander <magnus@hagander.net> writes:
> > >> Ok, Thom has merged these changes onto the current website code, and
> > >> I've put it up on http://magnus.webdev.postgresql.org - note that you
> > >> need to go back to 8.3 to actually see anything, because the db
> > >> doesn't have the latest docs.
> > >
> > > You know, I hate to say it, but this is just way too busy for my taste.
> > > The typography is screaming "look at me" instead of staying out of the
> > > way.  I can't imagine wanting to read any large amount of docs in this
> > > presentation.
> > >
> > > Maybe I'm in the minority.
> > 
> > Do you have any specific recommendations?  What would tone it down?
> 
> I find it very pleasant. It reminds me of the python docs which are nice
> to read as well.

I know you like the Python docs, and I think they _look_ good too at a
glance, but see this page:
http://docs.python.org/c-api/memory.html#examples

The many horizontal lines really break up the text blocks and make me
feel like I am reading through a mine field or obstacle course.

This might be part of the issue we are dealing with now in the new format.

--  Bruce Momjian  <bruce@momjian.us>        http://momjian.us EnterpriseDB
http://enterprisedb.com
 + It's impossible for everything to be true. +