incubator-clerezza-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Florent ANDRE (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (CLEREZZA-601) change hjs in @author to bblfish
Date Sun, 10 Jul 2011 11:00:00 GMT

    [ 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.

See this mail send by Bertrand Delacretaz on Stanbol ml :

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

        

Mime
View raw message