Received: from localhost (unknown [200.46.204.183]) by postgresql.org (Postfix) with ESMTP id 29DD79F9245 for ; Sun, 11 Nov 2007 15:29:44 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024) with ESMTP id 43514-03 for ; Sun, 11 Nov 2007 15:29:42 -0400 (AST) Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by postgresql.org (Postfix) with ESMTP id 755699F9244 for ; Sun, 11 Nov 2007 15:29:41 -0400 (AST) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.1/8.14.1) with ESMTP id lABJTZ19004964; Sun, 11 Nov 2007 14:29:35 -0500 (EST) To: Bruce Momjian cc: Albert Cervera i Areny , PostgreSQL-documentation Subject: Re: [PATCHES] Contrib docs v1 In-reply-to: <200711111816.lABIGdU15448@momjian.us> References: <200711111816.lABIGdU15448@momjian.us> Comments: In-reply-to Bruce Momjian message dated "Sun, 11 Nov 2007 13:16:39 -0500" Date: Sun, 11 Nov 2007 14:29:35 -0500 Message-ID: <4963.1194809375@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200711/33 X-Sequence-Number: 4566 Bruce Momjian writes: > Tom Lane wrote: >> What is the point of such a distinction? > If the contrib value is the source code itself then it seems a README is > more appropriate as people are not going to install the contrib module > itself --- they are using it only to learn. I find this argument pretty unconvincing. Most of the contrib modules serve at least some purpose as coding examples. If we set up a situation where all but one or two are documented in the main SGML docs, the net effect will be that people don't even know that the ones left out exist. Even a module that's only useful as an example won't be useful at all, if people don't find it. regards, tom lane