From: | Andrew Dunstan <andrew(at)dunslane(dot)net> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | Josh Berkus <josh(at)agliodbs(dot)com>, pgsql-hackers(at)postgresql(dot)org, Albert Cervera i Areny <albert(at)nan-tic(dot)com>, pgsql-docs(at)postgresql(dot)org |
Subject: | Re: [HACKERS] Contrib modules documentation online |
Date: | 2007-08-29 18:27:31 |
Message-ID: | 46D5BA93.5060801@dunslane.net |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-hackers |
Tom Lane wrote:
> Josh Berkus <josh(at)agliodbs(dot)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
From | Date | Subject | |
---|---|---|---|
Next Message | Mario Gonzalez | 2007-08-29 18:27:44 | Re: [HACKERS] Contrib modules documentation online |
Previous Message | Neil Conway | 2007-08-29 18:18:44 | Re: [HACKERS] Contrib modules documentation online |
From | Date | Subject | |
---|---|---|---|
Next Message | Mario Gonzalez | 2007-08-29 18:27:44 | Re: [HACKERS] Contrib modules documentation online |
Previous Message | Neil Conway | 2007-08-29 18:18:44 | Re: [HACKERS] Contrib modules documentation online |