Documentation - Comments

• How to comment efficiently:

  • use styles that don't break or discourage modification
  • entering and deleting # - / * = is not programming, it's a waste of time
  • describe the program first (in a Program Design Language) and then refine by real code
  • comment as you go along: commenting done later takes more time because you have to remember
  • not the number, but the efficiency of comments is important