Comments on Code Comments

Comments in codes are bad because…

  • Encourage poor programming habits: Developers are less inclined to use meaningful names for behaviors or make their code expressive as its explained in comments
  • Comments are a liability: Efforts to keep comments in sync with the modified code by other developers costs time and effort to update unless its absolutely necessary.

Actions:

  • You should rewrite your code so it’s easier to understand if your code does not explain itself well.
  • Use comments only when there are considerations regarding performance, availability and security.

Leave a Reply

Your email address will not be published. Required fields are marked *