Return-Path: Delivered-To: apmail-incubator-jspwiki-dev-archive@locus.apache.org Received: (qmail 66370 invoked from network); 31 Mar 2008 05:47:59 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 31 Mar 2008 05:47:59 -0000 Received: (qmail 20230 invoked by uid 500); 31 Mar 2008 05:47:58 -0000 Delivered-To: apmail-incubator-jspwiki-dev-archive@incubator.apache.org Received: (qmail 20219 invoked by uid 500); 31 Mar 2008 05:47:58 -0000 Mailing-List: contact jspwiki-dev-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: jspwiki-dev@incubator.apache.org Delivered-To: mailing list jspwiki-dev@incubator.apache.org Received: (qmail 20210 invoked by uid 99); 31 Mar 2008 05:47:58 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 30 Mar 2008 22:47:58 -0700 X-ASF-Spam-Status: No, hits=-0.0 required=10.0 tests=SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of Janne.Jalkanen@ecyrd.com designates 193.64.5.122 as permitted sender) Received: from [193.64.5.122] (HELO mail.ecyrd.com) (193.64.5.122) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 31 Mar 2008 05:47:07 +0000 Received: from [192.168.0.13] (cs181005170.pp.htv.fi [82.181.5.170]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by mail.ecyrd.com (Postfix) with ESMTP id 5090748200 for ; Mon, 31 Mar 2008 08:47:12 +0300 (EEST) Mime-Version: 1.0 (Apple Message framework v753) In-Reply-To: References: <2A43EE30-7601-47C5-80E6-2F044D4C68EE@ecyrd.com> <47EF42D8.9080301@altheim.com> <6498859D-8FDF-4715-9CF3-28B586AA29EA@ecyrd.com> Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed Message-Id: <32884AC6-1B05-4579-9A81-EE7F75F4B3E5@ecyrd.com> Content-Transfer-Encoding: 7bit From: Janne Jalkanen Subject: author-tags Was: Trunk is now open for 2.8 stuff. Date: Mon, 31 Mar 2008 08:46:44 +0300 To: jspwiki-dev@incubator.apache.org X-Mailer: Apple Mail (2.753) X-Virus-Checked: Checked by ClamAV on apache.org > I think we may be reading too much into the ASF guidelines by > recommending we remove @author tags. I know for sure that Apache is > not enforcing this guideline very strictly. For example, look at > the author tags for this source file: It is a strong SHOULD. And I kinda agree with it. > I agree with Murray: @author tags are valuable because they help > identify expertise and knowledge associated with particular bits of > code. They are good for "archeology." Removing them would do more > harm than good. I disagree. The SVN log and annotations very clearly spell out who did what. Are you sure @author-tags are updated every single time? If the file has patches from several dozens of files over several years, who really is the author? Is anyone removing @author -tags from code which no longer has any pieces of the original contribution left? I'm going to remove all @author tags with my name on them anyway and not add any new ones. Personally, I would much rather have the team get the credit than myself. If anyone needs to point any blaming fingers at anyone, the SVN history tells all that is necessary. To me, the presence of @author-tags is useless metadata, which causes more harm than good. Probably because I get all the emails asking for help, and I need to constantly defer people to the mailing list. /Janne