Re: [DOCS] Doc fixes and improvements

Tom Lane wrote:
> 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.

Yeah, I think you want the blocks to appear distinct, but not chop up
the text that is above/below it --- not an easy task.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

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