incubator-clerezza-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Henry Story <henry.st...@bblfish.net>
Subject Re: [jira] [Commented] (CLEREZZA-601) change hjs in @author to bblfish
Date Sun, 10 Jul 2011 11:18:10 GMT

On 10 Jul 2011, at 13:00, Florent ANDRE (JIRA) wrote:

> 
>    [ https://issues.apache.org/jira/browse/CLEREZZA-601?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13062713#comment-13062713
] 
> 
> Florent ANDRE commented on CLEREZZA-601:
> ----------------------------------------
> 
> @author is not a recommended annotation.

Ah. Ok. Thanks for pointing that out. I just saw a lot of those @author around, so I thought
at least they should be useful.  I don't suppose it's necessary to rewind that change though,
right?

Henry


> See this mail send by Bertrand Delacretaz on Stanbol ml :

thanks.

> 
> On Fri, Jul 8, 2011 at 10:32 AM, Alessandro Adamou <adamou@cs.unibo.it> wrote:
>>> ...what's the ASF way to deal with @author annotations in
>>> single classes? Do we put our Apache IDs there, or full names, or nothing at
>>> all?...
> The recommendation is to avoid @author tags [1] - among other reasons,
> they might cause people to contact developers directly (which we don't
> want - questions should go to our lists) and they quickly become stale
> when people work collectively on code.
> 
> The Whole Truth about who committed what is provided by svn annotate anyway.

> 
> -Bertrand
> 
> [1] http://www.apache.org/foundation/records/minutes/2004/board_minutes_2004_02_18.txt
> and
> http://mail-archives.apache.org/mod_mbox/www-community/200402.mbox/%3C403A144A.5040602@apache.org%3E
> 
> 
>> change hjs in @author to bblfish
>> --------------------------------
>> 
>>                Key: CLEREZZA-601
>>                URL: https://issues.apache.org/jira/browse/CLEREZZA-601
>>            Project: Clerezza
>>         Issue Type: Improvement
>>           Reporter: Henry Story
>> 
>> That is the handle these issues refer to
> 
> --
> This message is automatically generated by JIRA.
> For more information on JIRA, see: http://www.atlassian.com/software/jira
> 
> 

Social Web Architect
http://bblfish.net/


Mime
View raw message