Received: from maia.hub.org (maia-3.hub.org [200.46.204.243]) by mail.postgresql.org (Postfix) with ESMTP id 4A38F6360C8 for ; Mon, 13 Sep 2010 15:11:07 -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 63160-02-6 for ; Mon, 13 Sep 2010 18:10:59 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from spinlock.commandprompt.com (host-215.commandprompt.net [207.173.203.215]) by mail.postgresql.org (Postfix) with ESMTP id F3FC1633C96 for ; Mon, 13 Sep 2010 15:10:31 -0300 (ADT) Received: from localhost (localhost [127.0.0.1]) by spinlock.commandprompt.com (Postfix) with ESMTP id 64F5D348013; Mon, 13 Sep 2010 11:10:23 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at commandprompt.com Received: from spinlock.commandprompt.com ([127.0.0.1]) by localhost (spinlock.commandprompt.com.commandprompt.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Z+EcODUuzlni; Mon, 13 Sep 2010 11:10:18 -0700 (PDT) Received: from [192.168.1.132] (unknown [75.142.155.118]) by spinlock.commandprompt.com (Postfix) with ESMTPSA id C14B0348011; Mon, 13 Sep 2010 11:10:17 -0700 (PDT) Subject: Re: [DOCS] Doc fixes and improvements From: "Joshua D. Drake" Reply-To: jd@commandprompt.com To: Thom Brown Cc: Peter Eisentraut , Tom Lane , Magnus Hagander , Bruce Momjian , PostgreSQL www In-Reply-To: References: <201009101336.o8ADae526636@momjian.us> <29333.1284149151@sss.pgh.pa.us> <1284400050.4696.6.camel@vanquo.pezone.net> Content-Type: text/plain; charset="UTF-8" Organization: Command Prompt, Inc. Date: Mon, 13 Sep 2010 11:10:02 -0700 Message-ID: <1284401402.28610.32.camel@jd-desktop.unknown.charter.com> Mime-Version: 1.0 X-Mailer: Evolution 2.28.3 Content-Transfer-Encoding: 7bit X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.9 tagged_above=-5 required=5 tests=BAYES_00=-1.9 X-Spam-Level: X-Archive-Number: 201009/80 X-Sequence-Number: 19167 On Mon, 2010-09-13 at 18:51 +0100, Thom Brown wrote: > On 13 September 2010 18:47, Peter Eisentraut wrote: > > On fre, 2010-09-10 at 21:11 +0100, Thom Brown wrote: > >> Do you have any specific recommendations? What would tone it down? > > > > There are just too many things going on. Reduce the number of colors, > > reduce the number of different border designs (round, not round), make > > the borders less busy (remove the line), remove the shadows, reduce the > > number of different levels of indentation. > > > > It's a great CSS show case, and perhaps it's a good design for a web > > site (or perhaps not), but lengthy documentation text should probably be > > kept very simple. > > It sounds like you're recommending starting from scratch. I think > maybe someone else should give it a try instead then. I think Thom has gone down the right path here and that with respect, the curmudgeons need to go back to their fire and tea. Our current docs are pathetic visual representations of a quality product. The "only" change I could see at this point in the path that "might" improve the work that he is done, is to drop the shadow. The colors allow the information to be give priority to the information that is supposed to have priority. The indentation is directly applicable to the indentation of the content itself. Everything is rounded (that I saw) except tables. What *exactly* is the problem here? Oh and: Thanks to Bruce for actually working *with* the process and helping Thom based on his feedback. Sincerely, Joshua D. Drake -- PostgreSQL.org Major Contributor Command Prompt, Inc: http://www.commandprompt.com/ - 509.416.6579 Consulting, Training, Support, Custom Development, Engineering http://twitter.com/cmdpromptinc | http://identi.ca/commandprompt