コードは能弁であれ。コメントは謙虚であれ。

コードは能弁であれ。
コメントは謙虚であれ。


これが、私が思うコーディングのベストプラクティスです。
あくまでコードが主役です。
コードに喋らせてやってください。
コードに喋らせられずにコメントに逃げてばかりいると・・・


コメントが暴走するか、
コードに置いてきぼりにされてしまいます。
(つまりコードとコメントの整合性が取れなくなる。)


コメントはあくまで注釈程度にするべきで、謙虚にひっそりとコードを支えてやってください。