title: Good Use Cases of Comments
body: <p>I've always hated comments that fill half the screen with asterisks just to tell you that the function returns a string, I never read those comments.</p>
  
  <p>However, I do read comments that describe why something is done and how it's done (usually the single line comments in the code); those come in really handy when trying to understand someone else's code.</p>
  
  <p>But when it comes to writing comments, I don't write that, rather, I use comments only when writing algorithms in programming contests, I'd think of how the algorithm will do what it does then I'd write each one in a comment, then write the code that corresponds to that comment.</p>
  
  <p>An example would be:</p>
  
  <pre><code>//loop though all the names from n to j - 1
  </code></pre>
  
  <p>Other than that I can't imagine why anyone would waste valuable time writing comments when he could be writing code.</p>
  
  <p>Am I right or wrong? Am I missing something? What other good use cases of comments am I not aware of?</p>