Received: from localhost (unknown [200.46.204.191]) by postgresql.org (Postfix) with ESMTP id 627552E31A1 for ; Thu, 6 Dec 2007 12:21:35 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.191]) (amavisd-maia, port 10024) with ESMTP id 90801-05 for ; Thu, 6 Dec 2007 12:21:25 -0400 (AST) Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.170]) by postgresql.org (Postfix) with ESMTP id 61D6E2E01A8 for ; Thu, 6 Dec 2007 12:21:25 -0400 (AST) Received: by ug-out-1314.google.com with SMTP id j3so685385ugf for ; Thu, 06 Dec 2007 08:21:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; bh=7tUAixCRq6GBEi+kDRB7EuV2I9XzZIbHWQHB6EOO9Dc=; b=rDBDOxgTif6IIL0R3VlRoV2E9ke55WL9kLs6z1mRUe2Qx8xNoDpOvAbXkZ/3UKgi1hZQbNnsjL0e7WFnDfncTnrsViXdQfW7vzg5WOLUb/CoxTOlBcdNY9obksFrq7QzTRKmr82EnSb4nfl+KWM5lCG/EAtxS4M2++aijv6UGM4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=KRR/M5gMFlO48pbqq0EOFOJB/wJKQuOsR9thoYuX8K4d4JBAUdSjzlCjJOTOx5BlSiTT1Rk75YlQLKd5hTBvl3w1ot+9QJF9ijfGMdXfutFzSQ4qW1bQN4JU5GHa3jkNl5RQP3r0UDxbtSkhgYZtg9nDYZTO7xeD8QUXXAbsvds= Received: by 10.78.160.2 with SMTP id i2mr2519417hue.1196958083209; Thu, 06 Dec 2007 08:21:23 -0800 (PST) Received: by 10.78.132.19 with HTTP; Thu, 6 Dec 2007 08:21:23 -0800 (PST) Message-ID: <2b5e566d0712060821i4cb912a2g76940812adc40711@mail.gmail.com> Date: Thu, 6 Dec 2007 08:21:23 -0800 From: "Selena Deckelmann" To: "Tom Lane" , pgsql-hackers@postgresql.org, pgsql-docs@postgresql.org Subject: Re: Uniform policy for author credits in contrib module documentation? In-Reply-To: <3393.1196917132@sss.pgh.pa.us> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <3393.1196917132@sss.pgh.pa.us> X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200712/23 X-Sequence-Number: 4691 On Dec 5, 2007 8:58 PM, Tom Lane wrote: > If we do want to keep credits in the SGML pages, how extensive should > they be? ... > I don't have a strong opinion one way or the other, except that I think > we should have a uniform policy for all the contrib modules. One of the things that I used to do with the old HOWTO documentation from the Linux Documentation Project was jump directly to the Acknowledgement or Credit sections and read who the author had decided to thank, and then search for more information about those people and what they had done. While it might be a pain to maintain that information, it does humanize and provide context for a document. Also, the tradition of thanking people (or higher powers) and taking a few moments to reflect on who might have helped one accomplish something is a good one. Maybe I'm just being nostalgic, but I like that the content of credit sections is not uniform. Rather than remove credits, we could apply a regex to obfuscate the email addresses, and offer a mention to authors in the more general contributors area when packages are added. -selena -- Selena Deckelmann PDXPUG - Portland PostgreSQL Users Group http://pugs.postgresql.org/pdx http://www.chesnok.com/daily