From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
Cc: Albert Cervera i Areny <albert@nan-tic.com>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: [PATCHES] Contrib docs v1
Date: Sun, 11 Nov 2007 14:29:35 -0500
Message-ID: <4963.1194809375@sss.pgh.pa.us> (raw)
In-Reply-To: <200711111816.lABIGdU15448@momjian.us>
References: <200711111816.lABIGdU15448@momjian.us>
Bruce Momjian <bruce@momjian.us> 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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, bruce@momjian.us, albert@nan-tic.com
Subject: Re: [PATCHES] Contrib docs v1
In-Reply-To: <4963.1194809375@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox