You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Stephen Colebourne <sc...@btopenworld.com> on 2006/11/04 12:01:02 UTC
[collections-generics] [PROPOSAL] Remove all author and since version
tags
As this is a 'new' project, I propose that we:
- remove all @author tags - this complies with previous ASF board
suggestions
- remove all @since tags - as its incompatible anyway, and will probably
end up in a separate package, these have no real meaning
Any dissenting opinions?
First commits on this topic won't be until after 18th November 2006.
Stephen
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: [collections-generics] [PROPOSAL] Remove all author and since version tags
Posted by Rahul Akolkar <ra...@gmail.com>.
On 11/4/06, Stephen Colebourne <sc...@btopenworld.com> wrote:
> As this is a 'new' project, I propose that we:
>
> - remove all @author tags - this complies with previous ASF board
> suggestions
>
<snip/>
IMO new code should not contain author tags, gets tedious in many
ways. You may want to stop accepting contributions that contain these
(by requesting removal first).
-Rahul
> - remove all @since tags - as its incompatible anyway, and will probably
> end up in a separate package, these have no real meaning
>
> Any dissenting opinions?
> First commits on this topic won't be until after 18th November 2006.
>
> Stephen
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: [collections-generics] [PROPOSAL] Remove all author and since version tags
Posted by Sandy McArthur <sa...@apache.org>.
On 11/4/06, Stephen Colebourne <sc...@btopenworld.com> wrote:
> As this is a 'new' project, I propose that we:
>
> - remove all @author tags - this complies with previous ASF board
> suggestions
I maintain my position that if people didn't want their name there
they wouldn't have put it there and if someone put a non-trivial
amount of effort into something then they should receive credit. I
still think the ASF board's suggestion on this misguided unless they
are willing to anonymize the source repositories too.
> - remove all @since tags - as its incompatible anyway, and will probably
> end up in a separate package, these have no real meaning
I think all @since tags should be set to the first official release
they'll be in. While they provide little value for the "first" release
of code, their value increases over time as there are more official
releases. In a few years when my project at work is still using
collections 5.7 and collections 6.4 is the latest release it's nice to
be able to look at the Javadocs online and see if that method I want
to call has been around a while or in a newer release than the one
we're using. If people never forgot to put them in it would be fine
to only have @since tags on code added since the beginning. Since
people do forget, if they are supposed to always be there then you can
use code inspection tools to check to see where they are missing when
preparing a release candidate.
--
Sandy McArthur
"He who dares not offend cannot be honest."
- Thomas Paine
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
RE: [collections-generics] [PROPOSAL] Remove all author and since version tags
Posted by Gary Gregory <gg...@seagullsoftware.com>.
> -----Original Message-----
> From: Stephen Colebourne [mailto:scolebourne@btopenworld.com]
> Sent: Saturday, November 04, 2006 3:01 AM
> To: Jakarta Commons Developers List
> Subject: [collections-generics] [PROPOSAL] Remove all author and since
version
> tags
>
> As this is a 'new' project, I propose that we:
>
> - remove all @author tags - this complies with previous ASF board
> suggestions
+1
> - remove all @since tags - as its incompatible anyway, and will
probably
> end up in a separate package, these have no real meaning
If the plan is to put code that now has @since in a packages, then +1.
> Any dissenting opinions?
> First commits on this topic won't be until after 18th November 2006.
>
> Stephen
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org