A Philosophy of Software Design › Comments Should Describe Things that Aren't Obvious from the Code

TL;DR

• コメントには、コードを読んでも分からないことを書くべきである。