pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Thom Brown <thom@linux.com>
Cc: Magnus Hagander <magnus@hagander.net>
Cc: Bruce Momjian <bruce@momjian.us>
Cc: PostgreSQL www <pgsql-www@postgresql.org>
Subject: Re: [DOCS] Doc fixes and improvements
Date: Fri, 10 Sep 2010 16:56:44 -0400
Message-ID: <420.1284152204@sss.pgh.pa.us> (raw)
In-Reply-To: <AANLkTikL_38dMk1ge3pynOKTp0TciYyyVr4+d_Qdbp3E@mail.gmail.com>
References: <AANLkTinZRcNYdooNW-rZQuS_iUctkPSyTxiVqgt4h034@mail.gmail.com>
	<201009101336.o8ADae526636@momjian.us>
	<AANLkTi=dUW8yOepUAA97y=qGiAcMjAb01EOv3VVAwDc0@mail.gmail.com>
	<AANLkTikeZUOv7ErYeQJcD4bi5oaQ4_0x_8Yp+supuLcv@mail.gmail.com>
	<AANLkTimd+Q9m1VJ4z6pqwh28xgSpsDP9OVz+sjfbDaoJ@mail.gmail.com>
	<AANLkTin8-+HDRpJmJQt-VY445y2rOjF+cUXKHvdNTWcw@mail.gmail.com>
	<29333.1284149151@sss.pgh.pa.us>
	<AANLkTimsSY-wtuUOGoSP3sNkhPXy1R3aY-BKbJa6fz5Y@mail.gmail.com>
	<29720.1284150356@sss.pgh.pa.us>
	<AANLkTikL_38dMk1ge3pynOKTp0TciYyyVr4+d_Qdbp3E@mail.gmail.com>

Thom Brown <thom@linux.com> writes:
> On 10 September 2010 21:25, Tom Lane <tgl@sss.pgh.pa.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



view thread (76+ messages)  latest in thread

Message-ID: <420.1284152204@sss.pgh.pa.us>
Permalink:  ../420.1284152204@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/420.1284152204@sss.pgh.pa.us

 · 

reply
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: tgl@sss.pgh.pa.us, thom@linux.com, magnus@hagander.net, bruce@momjian.us, pgsql-www@postgresql.org
  Subject: Re: [DOCS] Doc fixes and improvements
  In-Reply-To: <420.1284152204@sss.pgh.pa.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