Received: from maia.hub.org (maia-3.hub.org [200.46.204.243]) by mail.postgresql.org (Postfix) with ESMTP id 2CC8A63307A for ; Fri, 10 Sep 2010 17:56:55 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia, port 10024) with ESMTP id 85342-09 for ; Fri, 10 Sep 2010 20:56:47 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by mail.postgresql.org (Postfix) with ESMTP id E558A632F55 for ; Fri, 10 Sep 2010 17:56:47 -0300 (ADT) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.2/8.14.2) with ESMTP id o8AKuikW000421; Fri, 10 Sep 2010 16:56:44 -0400 (EDT) To: Thom Brown cc: Magnus Hagander , Bruce Momjian , PostgreSQL www Subject: Re: [DOCS] Doc fixes and improvements In-reply-to: References: <201009101336.o8ADae526636@momjian.us> <29333.1284149151@sss.pgh.pa.us> <29720.1284150356@sss.pgh.pa.us> Comments: In-reply-to Thom Brown message dated "Fri, 10 Sep 2010 21:47:06 +0100" Date: Fri, 10 Sep 2010 16:56:44 -0400 Message-ID: <420.1284152204@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.909 tagged_above=-5 required=5 tests=BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01, WEIRD_PORT=0.001 X-Spam-Level: X-Archive-Number: 201009/41 X-Sequence-Number: 19128 Thom Brown writes: > On 10 September 2010 21:25, Tom Lane 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