> > As a best practice, we should also remove the > > @author tags, and be sure to credit all new contributions in the > > commit logs. > > To clarify, this is up to the community, but most have gone towards > removing the @author tags. Personally I just never put my name in one > anymore and avoid the discussions, but I'm +1 to not bothering with > @authors.
I am still a bit confused as to why this is a best practice. I actually like having the @author tags so that I can know who "maintains" that piece of code. To me it's not about giving credit it's more about responsibility and it helps me to know who owns what pieces of code so that if I have questions about it I know who to contact first. I am not particularly tied to the @author javdoc markup if we don't want the author to show up in our javadocs, but I do like having that indication somewhere in the file. I feel that svn doesn't do quite as good a job of that because often times commit notes are not very specific and even if the last few commits are from user XXX that doesn't mean that XXX is the primary maintainer of that code. I also think it's more of a pain to go back and lookup svn commit logs versus just seeing the @author tag in the code. -- Allen
