title: Best Practice for comments in Java source files?
body: <p>This doesn't <em>have</em> to be Java, but it's what I'm dealing with. <em>Also, not so much concerned with the methods and details of those, I'm wondering about the overall class file.</em></p>
  
  <p>What are some of the things I really need to have in my comments for a given class file? At my corporation, the only things I really can come up with: </p>
  
  <ul>
  <li>Copyright/License</li>
  <li>A description of what the class does</li>
  <li>A last modified date?</li>
  </ul>
  
  <p>Is there anything else which should be provided?</p>
  
  <p>One logical thing I've heard is to keep authors out of the header because it's redundant with the information already being provided via source control.</p>
  
  <p><strong>Update:</strong>
  JavaDoc can be assumed here, but I'm really more concerned about the details of what's good to include content-wise, whether it's definitive meta-data that can be mined, or the more loose, WHY etc...</p>