Received: from localhost (unknown [200.46.204.191]) by postgresql.org (Postfix) with ESMTP id D38F99FB1D9 for ; Fri, 19 Oct 2007 07:41:53 -0300 (ADT) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.191]) (amavisd-maia, port 10024) with ESMTP id 31577-06 for ; Fri, 19 Oct 2007 07:41:45 -0300 (ADT) X-Greylist: from auto-whitelisted by SQLgrey-1.7.5 Received: from mx1.magproductions.nl (mx1.magproductions.nl [87.249.97.171]) by postgresql.org (Postfix) with ESMTP id 827A19FA690 for ; Fri, 19 Oct 2007 07:41:45 -0300 (ADT) Received: from gw.office.mag.hq ([172.27.1.1] helo=localhost) by mx1.magproductions.nl with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.63) (envelope-from ) id 1IipII-00055t-Vc; Fri, 19 Oct 2007 12:41:39 +0200 Received: from magenta.office.mag.hq ([172.27.1.6]) by localhost with esmtp (Exim 4.63) (envelope-from ) id 1IipID-0005RM-L8; Fri, 19 Oct 2007 12:41:25 +0200 Message-ID: <471889D4.5010500@magproductions.nl> Date: Fri, 19 Oct 2007 12:41:24 +0200 From: Alban Hertroys User-Agent: Thunderbird 1.5.0.12 (X11/20070604) MIME-Version: 1.0 To: Steve Crawford CC: Alvaro Herrera , pgsql-general@postgresql.org Subject: Re: Abbreviation list References: <4717AC13.5010609@pinpointresearch.com> <20071018191047.GN29379@alvh.no-ip.org> <4717F038.1060709@pinpointresearch.com> In-Reply-To: <4717F038.1060709@pinpointresearch.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-MAG-Spam-Score: -2.6 X-MAG-Spam-Level: -- X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200710/966 X-Sequence-Number: 122258 Steve Crawford wrote: > My vote is to add "Appendix I. Abbreviations". Don't know if it's > practical for 8.3 documentation but it would be nice to add even if it > only has a few entries as additional ones could be collected via the > user notes. > > I suggest as a discussion starting-point the following inclusion criteria: > > 1. Any abbreviation/acronym that appears in the PostgreSQL documentation > (even if those terms may not be PG specific - we shouldn't assume that > everyone knows them). Good documentation practice recommends defining > abbreviations the first time they are used. Better still, ensure that > they are in the abbreviation list. Isn't this just what the ABBR tag in html is for? -- Alban Hertroys a.hertroys@magproductions.nl magproductions b.v. T: ++31(0)534346874 F: ++31(0)534346876 M: I: www.magproductions.nl A: Postbus 416 7500 AK Enschede // Integrate Your World //