title: Javadoc @author tag good practices
body: <p>I'm wondering about best practices when creating Javadocs. I have a project with many files. Code has been created by many developers. Each file has an annotation <code>@author</code>, so it is obvious who has created a particular class. </p>
  
  <p>But when some other developer adds new code to a file, modifies it, etc., how should he inform the rest of the team that he has created some new function or has modified existing code? In other words, how should we "keep the Javadocs compatible with reality"? ;)</p>
  
  <ul>
  <li>Add his name to the existing <code>@author</code> tag? Then, it is easier to identify who to ask in case of any doubts.</li>
  <li>Add an <code>@author</code> tag to each new method, inner class, etc.?</li>
  </ul>
  
  <p>Of course, since we use SVN, it is easy to investigate who has made what, but for keeping things clear this Javadoc stuff should be taken into consideration as well.</p>
  
  <p>What's the best way to use these <code>@author</code> tags?</p>