Received: from maia.hub.org (unknown [200.46.208.211]) by mail.postgresql.org (Postfix) with ESMTP id 76E5863406C for ; Mon, 5 Apr 2010 11:07:12 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.208.211]) (amavisd-maia, port 10024) with ESMTP id 88103-07 for ; Mon, 5 Apr 2010 14:06:52 +0000 (UTC) Received: from mx1.hub.org (mx1.hub.org [200.46.208.106]) by mail.postgresql.org (Postfix) with ESMTP id 31A5C632547 for ; Mon, 5 Apr 2010 11:03:57 -0300 (ADT) 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 mx1.hub.org (Postfix) with ESMTP id A2746326773B for ; Mon, 5 Apr 2010 11:03:17 -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 o35E2CHR020318; Mon, 5 Apr 2010 10:02:12 -0400 (EDT) To: Rafael Martinez cc: pgsql-docs@postgresql.org Subject: Re: Documentation and explanatory diagrams In-reply-to: <4BB9E69F.9080203@usit.uio.no> References: <4BB9E69F.9080203@usit.uio.no> Comments: In-reply-to Rafael Martinez message dated "Mon, 05 Apr 2010 15:33:19 +0200" Date: Mon, 05 Apr 2010 10:02:12 -0400 Message-ID: <20317.1270476132@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.257 tagged_above=-10 required=5 tests=AWL=-1.072, BAYES_40=-0.185 X-Spam-Level: X-Archive-Number: 201004/30 X-Sequence-Number: 5429 Rafael Martinez writes: > I am wondering if we have ever evaluated the use of explanatory diagrams > in the PostgreSQL documentation. There actually used to be some. We've moved away from them, I believe, because of the difficulty of maintenance; which stems mainly from the lack of any universally-available tools. Unless you can tell me what you're going to draw the diagram with and how people on Unix, Windows, or Mac could modify it later, I'm going to not be very interested ... regards, tom lane