Re: [HACKERS] Uniform policy for author credits in contrib module documentation?

From: Andrew Dunstan <andrew(at)dunslane(dot)net>
To: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Josh Berkus <josh(at)agliodbs(dot)com>, pgsql-hackers(at)postgresql(dot)org, pgsql-docs(at)postgresql(dot)org
Subject: Re: [HACKERS] Uniform policy for author credits in contrib module documentation?
Date: 2007-12-07 17:03:52
Message-ID: 47597CF8.20307@dunslane.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

Joshua D. Drake wrote:
> Tom Lane wrote:
>> Josh Berkus <josh(at)agliodbs(dot)com> writes:
>>> Historically, the only way to troubleshoot some of the contrib
>>> modules was to e-mail the author. If people think that we've
>>> reached a standard that everything in /contrib is now
>>> well-documented and supported by the general community, the I
>>> suppose we don't need contact information. I'm not so sure myself.
>>
>> I do not think that we should encourage people to mail the authors first
>> rather than pgsql-bugs. For one thing, a lot of those addresses are
>> dead, and some of the ones that aren't don't respond especially fast.
>>
>> If the community-at-large can't handle a bug, we certainly have enough
>> institutional memory to try to contact the original author, even if that
>> address isn't in the SGML docs.
>>
>
> Perhaps the at a minimum the email goes in the commit?
>

I don't see any reason, unless we're going to start doing that for all
contributions. 'contrib' is a serious misnomer anyway, and there's no
reason to think in general that the original author is specially
responsible for any of it. I think Tom's point is entirely valid.

cheers

andrew

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Simon Riggs 2007-12-07 18:22:10 Re: [HACKERS] "distributed checkpoint"
Previous Message Joshua D. Drake 2007-12-07 16:08:30 Re: [HACKERS] Uniform policy for author credits in contrib module documentation?

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 2007-12-07 17:09:29 Re: Release Note Changes
Previous Message Joshua D. Drake 2007-12-07 16:08:30 Re: [HACKERS] Uniform policy for author credits in contrib module documentation?