title: What is the proper way to document files, classes and constructors?
body: <p>What is the most useful/most standard/least surprising way to consistently write comment blocks for constructors and classes and files containing just a single class?</p>
  
  <ul>
  <li>Comment blocks for classes, not constructors</li>
  <li>Comment blocks for constructors, not classes</li>
  <li>Comment blocks for both constructors and classes -> In that case what sort of details should go in each?</li>
  </ul>
  
  <p>And then the file itself? Does this need a comment block if it just contains a single class? What details should go there?</p>
  
  <p>I want to try and avoid, as much as possible, repetition between class, constructor and file comment blocks.</p>