Received: from localhost (unknown [200.46.204.191]) by postgresql.org (Postfix) with ESMTP id 063439FB6D7; Thu, 30 Aug 2007 10:27:34 -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 18601-03-7; Thu, 30 Aug 2007 10:27:30 -0300 (ADT) X-Greylist: from auto-whitelisted by SQLgrey-1.7.5 X-Greylist: from auto-whitelisted by SQLgrey-1.7.5 Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by postgresql.org (Postfix) with ESMTP id 453B39FB757; Thu, 30 Aug 2007 10:27:26 -0300 (ADT) 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 l7UDQiW9026320; Thu, 30 Aug 2007 09:26:44 -0400 (EDT) To: Andrew Dunstan cc: Peter Eisentraut , pgsql-docs@postgresql.org, Josh Berkus , pgsql-hackers@postgresql.org, Albert Cervera i Areny Subject: Re: [HACKERS] Contrib modules documentation online In-reply-to: <46D6C279.5050200@dunslane.net> References: <200708290157.07968.albert@nan-tic.com> <7046.1188410001@sss.pgh.pa.us> <46D5BA93.5060801@dunslane.net> <200708301336.01489.peter_e@gmx.net> <46D6C279.5050200@dunslane.net> Comments: In-reply-to Andrew Dunstan message dated "Thu, 30 Aug 2007 09:13:29 -0400" Date: Thu, 30 Aug 2007 09:26:44 -0400 Message-ID: <26319.1188480404@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200708/43 X-Sequence-Number: 4390 Andrew Dunstan writes: > If you want to design a pluggable documentation system then go for it, > but it's not required by what I understand is the consensus plan for > contrib. I thought a large part of the desire was to improve the visibility of the contrib docs, ie, put the docs under the noses of people who have *not* installed or even heard of the modules. So "it's not in the docs unless you installed it" seems counter to the point. regards, tom lane