From: Bruce Momjian <bruce@momjian.us>
To: Thom Brown <thom@linux.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Magnus Hagander <magnus@hagander.net>
Cc: PostgreSQL www <pgsql-www@postgresql.org>
Subject: Re: [DOCS] Doc fixes and improvements
Date: Fri, 10 Sep 2010 16:53:55 -0400 (EDT)
Message-ID: <201009102053.o8AKrti17191@momjian.us> (raw)
In-Reply-To: <AANLkTikL_38dMk1ge3pynOKTp0TciYyyVr4+d_Qdbp3E@mail.gmail.com>
Thom Brown wrote:
> On 10 September 2010 21:25, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> > Thom Brown <thom@linux.com> writes:
> >> On 10 September 2010 21:05, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> >>> 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 still think the colored backgrounds are overused, and there's way too
> > much bold text. ?AFAICS all the fixed-width-font text is now bold too,
> > to no improvement in readability.
>
> The fixed-width-font text in examples shouldn't appear bold as I've
> applied no such style to those.
>
> How about this:
> http://pgweb.darkixion.com:8081/docs/8.4/static/sql-syntax-lexical.html
>
> Lighter example boxes, slightly smaller monospace and no bold
> monospace text within paragraphs on the page.
>
> The intention of making a clear visual distinction between normal
> paragraph sections and examples/output was to make it easier to scan.
Looks much better. Here is "normal":
http://momjian.us/tmp/pg_manual4.png
and here is "Large":
http://momjian.us/tmp/pg_manual5.png
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, thom@linux.com, tgl@sss.pgh.pa.us, magnus@hagander.net, pgsql-www@postgresql.org
Subject: Re: [DOCS] Doc fixes and improvements
In-Reply-To: <201009102053.o8AKrti17191@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox