Received: from localhost (unknown [200.46.204.191]) by postgresql.org (Postfix) with ESMTP id C1CCE9FA10A for ; Sun, 14 Oct 2007 10:11:39 -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 87890-01 for ; Sun, 14 Oct 2007 10:11:39 -0300 (ADT) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.5 Received: from mail.gmx.net (mail.gmx.net [213.165.64.20]) by postgresql.org (Postfix) with SMTP id 7C2D39FA2EC for ; Sun, 14 Oct 2007 10:05:18 -0300 (ADT) Received: (qmail invoked by alias); 14 Oct 2007 13:05:16 -0000 Received: from xdsl-87-79-50-171.netcologne.de (EHLO colt.pezone.net) [87.79.50.171] by mail.gmx.net (mp051) with SMTP; 14 Oct 2007 15:05:16 +0200 X-Authenticated: #495269 X-Provags-ID: V01U2FsdGVkX19ht2chWyRh9z0J3vW2q8M2P4ky7hkU1bcXpgmY48 6lQotewyU/w0VI From: Peter Eisentraut To: Albert Cervera i Areny Subject: Re: Tips needed for contrib doc Date: Sun, 14 Oct 2007 15:05:14 +0200 User-Agent: KMail/1.9.7 Cc: pgsql-docs@postgresql.org References: <200710102315.50067.albert@nan-tic.com> <200710121947.15037.peter_e@gmx.net> <200710122004.44884.albert@nan-tic.com> In-Reply-To: <200710122004.44884.albert@nan-tic.com> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-15" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200710141505.14690.peter_e@gmx.net> X-Y-GMX-Trusted: 0 X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200710/44 X-Sequence-Number: 4465 Albert Cervera i Areny wrote: > Not that I want to make each module a reference. With previous > discussions we seemed to agree that: > > - It should go into the References part of the documentation (right > after "III. PostgreSQL Server Applications). > - Each module docs should be in a single page, mainly because some > contrib modules have/require very little documentation. It think you should structure the documentation by content, not by output format. You could make each module a section or a chapter, as you choose. -- Peter Eisentraut http://developer.postgresql.org/~petere/