james-server-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Serge Knystautas" <ser...@lokitech.com>
Subject Re: [VOTE] Drop @author tags from source files
Date Wed, 04 Dec 2002 07:24:30 GMT
+1 to removing named authors, but -0 putting to @author james dev team... I
don't think an author tag is worth having at all.

With regards to naming/maintaining contributors, the policy I had been using
(a long while back) is as follows:
- if you get a patch (or a great bug report) from someone, you put their
name and email address in the commit message.
- when you update the changelog, you can either attribute a change to the
committer, or the person mentioned in the commit message if it is so
specified.
- if it's a new person, you add their name and email address to the top of
the changelog (so you can define the new initials... you have to see the xml
file to understand).

I think it's important to credit in the changelogs of who did what, as the
changelog is the real meassure of the vitality and velocity of the project,
and the people doing that deserve recognition (IMHO).  This continues the
shift away from @author tags, which credit who *did* what, to changelogs,
which credit who *is doing* what.

Am I just getting too vitriolic at this point?

Serge Knystautas
Loki Technologies
http://www.lokitech.com/

----- Original Message -----
From: "Darrell DeBoer" <darrell@apache.org>
To: <james-dev@jakarta.apache.org>
Sent: Tuesday, December 03, 2002 8:03 PM
Subject: [VOTE] Drop @author tags from source files


> G'day,
>
> The Avalon project recently voted to remove all author names from source
> files, and replace them with the mailing list address. A few ASF members
and
> long-time Jakarta developers commented on what a good idea this was, Noel
> forwarded this to the list:
> http://marc.theaimsgroup.com/?l=james-dev&m=103825695101689&w=2
>
> I think that moving into James3, this would be good for us as well. I'm
all
> for the notion of "collective code ownership", and I think @author tags
make
> this a little harder. (I also worry about spambot finding my email address
in
> the source).
>
> So, I propose the following vote:
> <vote>
> 1) We replace all @author tags in the source with a single line
> @author <a href="mailto:james-dev@jakarta.apache.org">James Development
> Team</a>
>
> 2) We make sure that any author that has had their name removed gets a
mention
> in the contributors page.
> </vote>
>
> We need to come up with a simple policy for adding names to the
contributors
> page. Maybe simply getting a patch applied would be sufficient..
>
> --
> ciao,
> Daz



--
To unsubscribe, e-mail:   <mailto:james-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:james-dev-help@jakarta.apache.org>


Mime
View raw message