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(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> > > Magnus Hagander <magnus(at)hagander(dot)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(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

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