From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | Thom Brown <thom(at)linux(dot)com> |
Cc: | Magnus Hagander <magnus(at)hagander(dot)net>, Bruce Momjian <bruce(at)momjian(dot)us>, PostgreSQL www <pgsql-www(at)postgresql(dot)org> |
Subject: | Re: [DOCS] Doc fixes and improvements |
Date: | 2010-09-10 20:56:44 |
Message-ID: | 420.1284152204@sss.pgh.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-www |
Thom Brown <thom(at)linux(dot)com> writes:
> On 10 September 2010 21:25, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>> 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.
Hmm. I'm seeing nothing but boldface on Magnus' pages, using Safari.
> How about this:
> http://pgweb.darkixion.com:8081/docs/8.4/static/sql-syntax-lexical.html
Curiously, that *doesn't* show as bold.
> The intention of making a clear visual distinction between normal
> paragraph sections and examples/output was to make it easier to scan.
Agreed, but a little goes a long way. If you overdo it, it'll grate on
the reader after twenty or thirty pages. The example blocks on this
page are suitably subtle, maybe even a bit too far --- I find that
depending on what angle I look at my LCD display, the background color
can be practically indistinguishable from the rest of the page. But
at other angles there's a clear distinction.
regards, tom lane
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2010-09-10 20:59:52 | Re: [DOCS] Doc fixes and improvements |
Previous Message | Thom Brown | 2010-09-10 20:56:38 | Re: [DOCS] Doc fixes and improvements |
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2010-09-10 20:59:52 | Re: [DOCS] Doc fixes and improvements |
Previous Message | Thom Brown | 2010-09-10 20:56:38 | Re: [DOCS] Doc fixes and improvements |