コメントは抽象的にすること
from
Modifying Existing Code
コメントはコードよりも抽象的(コードの詳細を反映していない)な方がメンテナンスしやすい
一般的に最も有用な(単にコードを繰り返すだけではない)コメントは、メンテンナンスも簡単
ただし、
詳細で正確なコメントが必要なケース
もある