Received: from maia.hub.org (maia-5.hub.org [200.46.204.29]) by mail.postgresql.org (Postfix) with ESMTP id A2BF96323B2 for ; Sat, 3 Jul 2010 09:09:06 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024) with ESMTP id 91851-05 for ; Sat, 3 Jul 2010 12:08:59 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from exprod7og113.obsmtp.com (exprod7og113.obsmtp.com [64.18.2.179]) by mail.postgresql.org (Postfix) with SMTP id 07A106322F5 for ; Sat, 3 Jul 2010 09:08:58 -0300 (ADT) Received: from source ([209.85.215.52]) by exprod7ob113.postini.com ([64.18.6.12]) with SMTP ID DSNKTC8oWAnzq18i8YPulhEW7C98q9bDNowt@postini.com; Sat, 03 Jul 2010 05:08:58 PDT Received: by ewy20 with SMTP id 20so1310054ewy.25 for ; Sat, 03 Jul 2010 05:08:56 -0700 (PDT) Received: by 10.213.34.3 with SMTP id j3mr371586ebd.65.1278158936041; Sat, 03 Jul 2010 05:08:56 -0700 (PDT) Received: from [192.168.1.117] (dsl-hkibrasgw2-ff7ac300-240.dhcp.inet.fi [88.195.122.240]) by mx.google.com with ESMTPS id x54sm14951421eeh.23.2010.07.03.05.08.53 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sat, 03 Jul 2010 05:08:54 -0700 (PDT) Message-ID: <4C2F2854.4090503@enterprisedb.com> Date: Sat, 03 Jul 2010 15:08:52 +0300 From: Heikki Linnakangas User-Agent: Mozilla/5.0 (X11; U; Linux i686; fi-FI; rv:1.9.1.10) Gecko/20100619 Iceowl/1.0b1 Icedove/3.0.5 MIME-Version: 1.0 To: Robert Haas CC: Bruce Momjian , "Marc G. Fournier" , Tom Lane , Alvaro Herrera , Peter Eisentraut , Rafael Martinez , pgsql-docs Subject: Re: Documentation and explanatory diagrams References: <201007022207.o62M7mX02724@momjian.us> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-4.2 tagged_above=-5 required=5 tests=BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3 X-Spam-Level: X-Archive-Number: 201007/33 X-Sequence-Number: 5689 On 03/07/10 02:02, Robert Haas wrote: > The page_layout image is kinda confusing - I can tell what the purple > and brown arrows are supposed to represent, but only because I already > know what they're supposed to mean. I realize that these are just sample images, but I'd like to enact a strict rule for any diagrams we include in the docs: All diagrams must have a key. Otherwise you don't know what all the boxes and arrows mean. Data flow, control flow, dependency, inheritance, or what? -- Heikki Linnakangas EnterpriseDB http://www.enterprisedb.com