Summary of “My 3 Rules for Documenting Code” article.

  1. Names (classes, variables, functions) should explain What (what is it? what does this function do?).
  2. Code should explain How (how is it implemented?).
  3. Comments should explain Why (why is it implemented this way?).

Added to the Collection of links.