モジュール設計上の決定を、別のモジュールでコメントし直さないこと

e.g. メソッド呼び出し

呼び出されたメソッドで何が起こるかを説明するコメントは書かない

読み手は知りたければ、そのメソッドのインタフェースコメントを見るべき

メソッドを選択するか、マウスをホバーすると、そのメソッドのインタフェースコメントを IDE が表示してくれるので、メソッド呼び出しで何が起きるかを説明するコメントは不要