Option 2 is fine by me... -----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of Paul Bakker Sent: donderdag 24 november 2011 14:19 To: [email protected] Subject: Re: [Amdatu-developers] Code convention on @author?
+1 for 2 We should add this to an Eclipse/Intellij template too (for those of us who like to use an IDE ;-) ) Paul On Nov 24, 2011, at 10:28 AM, Bram de Kruijff wrote: > 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 _______________________________________________ Amdatu-developers mailing list [email protected] http://lists.amdatu.org/mailman/listinfo/amdatu-developers _______________________________________________ Amdatu-developers mailing list [email protected] http://lists.amdatu.org/mailman/listinfo/amdatu-developers
