Usually many folks contribute to the an application development process (say a java / j2ee project). Sometimes a single person (say foo@bar.com) is responsible writing the code for a certain file or certain other folks might have changed the code.
Do you attribute author information on top of the file for any user who makes a modification like scenario 2 mentioned below or just the primary author as in scenario 1? Is there a specific order in which author information should be added on a change?
/**
* @author Foo Bar, (foo@bar.com)
*
*/
or
/**
* @author Foo Bar, (foo@bar.com)
* @author Foo Foo, (foo@foo.com)
* @author Bar Bar, (bar@bar.com)
*
*/
Personally I don’t think that authors should be listed in the code. There are several reasons for this: