Received: from maia.hub.org (maia-3.hub.org [200.46.204.243]) by mail.postgresql.org (Postfix) with ESMTP id BB5936326CD for ; Sat, 11 Sep 2010 10:26:08 -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 64896-07 for ; Sat, 11 Sep 2010 13:25:59 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from momjian.us (momjian.us [70.90.9.53]) by mail.postgresql.org (Postfix) with ESMTP id 0D0E163258F for ; Sat, 11 Sep 2010 10:26:00 -0300 (ADT) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id o8BDPqg00198; Sat, 11 Sep 2010 09:25:52 -0400 (EDT) From: Bruce Momjian Message-Id: <201009111325.o8BDPqg00198@momjian.us> Subject: Re: [DOCS] Doc fixes and improvements In-Reply-To: <1284150150.5188.24.camel@jd-desktop.unknown.charter.com> To: jd@commandprompt.com Date: Sat, 11 Sep 2010 09:25:51 -0400 (EDT) CC: Thom Brown , Tom Lane , Magnus Hagander , PostgreSQL www X-Mailer: ELM [version 2.4ME+ PL124 (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201009/50 X-Sequence-Number: 19137 Joshua D. Drake wrote: > On Fri, 2010-09-10 at 21:11 +0100, Thom Brown wrote: > > On 10 September 2010 21:05, Tom Lane wrote: > > > Magnus Hagander writes: > > >> Ok, Thom has merged these changes onto the current website code, and > > >> I've put it up on http://magnus.webdev.postgresql.org - note that you > > >> need to go back to 8.3 to actually see anything, because the db > > >> doesn't have the latest docs. > > > > > > 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 find it very pleasant. It reminds me of the python docs which are nice > to read as well. I know you like the Python docs, and I think they _look_ good too at a glance, but see this page: http://docs.python.org/c-api/memory.html#examples The many horizontal lines really break up the text blocks and make me feel like I am reading through a mine field or obstacle course. This might be part of the issue we are dealing with now in the new format. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + It's impossible for everything to be true. +