From: Andrew Dunstan <andrew@dunslane.net>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Josh Berkus <josh@agliodbs.com>
Cc: pgsql-hackers@postgresql.org, Albert Cervera i Areny <albert@nan-tic.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: [HACKERS] Contrib modules documentation online
Date: Wed, 29 Aug 2007 14:27:31 -0400
Message-ID: <46D5BA93.5060801@dunslane.net> (raw)
In-Reply-To: <7046.1188410001@sss.pgh.pa.us>
References: <200708290157.07968.albert@nan-tic.com>
<200708291009.07942.josh@agliodbs.com>
<7046.1188410001@sss.pgh.pa.us>
Tom Lane wrote:
> Josh Berkus <josh@agliodbs.com> writes:
>
>> If we go ahead with this, I'll commit to doing a contrib README
>> cleanup so the doc system works better.
>>
>
> Why wouldn't we just remove the README files altogether? I can't
> see maintaining duplicate sets of documentation.
>
>
>
Right.
Also, let's recall what has previously been discussed for contrib,
namely that we break it out into standard modules (think Perl standard
modules) and other tools, and that we abandon the wholly misleading
"contrib" name altogether. I really want to see that happen next
release. Getting the modules properly documented is a very important
milestone along the way to getting that done. Maybe then the modules
will be considered more first class citizens (until the buildfarm came
along they were often hardly tested at all).
cheers
andrew
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: andrew@dunslane.net, tgl@sss.pgh.pa.us, josh@agliodbs.com, albert@nan-tic.com
Subject: Re: [HACKERS] Contrib modules documentation online
In-Reply-To: <46D5BA93.5060801@dunslane.net>
* 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