From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.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 13:16:39 -0500 (EST)
Message-ID: <200711111816.lABIGdU15448@momjian.us> (raw)
In-Reply-To: <19053.1194795737@sss.pgh.pa.us>
Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Uh, don't start converting them yet. I now realize that
> > /contrib/dict_int is an example and just like the stuff in /contrib/spi
> > perhaps shouldn't have its docs moved to SGML.
>
> What makes you realize any such thing? You could make that argument for
> test_parser, probably, but the dict modules are useful in their own
> right.
>
> > Should we leave example /contrib modules documented in READMEs?
>
> 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.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
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: bruce@momjian.us, tgl@sss.pgh.pa.us, albert@nan-tic.com
Subject: Re: [PATCHES] Contrib docs v1
In-Reply-To: <200711111816.lABIGdU15448@momjian.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