Hi list,

noticed there is nothing explicit in out code conventions on the use
of the @author tag. Throughout the code base the is in-consist use
ranging from no javadoc at all to to multiple non-descriptive author
ids. As these things go they are typically not accurate when taking
commit history into account. Don't like it. I'd propose one out of the
following two options, both practiced in many related OSS projects:

1) Don't use the author tag. It does not really contribute anything does it...
2) Use generic @author <a
href="mailto:[email protected]";>Amdatu Project Team</a>

My +1  goes to the latter because I find it more aesthetically
pleasing :) If nobody objects I'll document it as the recommended way.

regards,
Bram
_______________________________________________
Amdatu-developers mailing list
[email protected]
http://lists.amdatu.org/mailman/listinfo/amdatu-developers

Reply via email to