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

コードは能弁であれ。

コメントは謙虚であれ。

これが、私が思うコーディングのベストプラクティスです。

あくまでコードが主役です。

コードに喋らせてやってください。

コードに喋らせられずにコメントに逃げてばかりいると・・・

コメントが暴走するか、

コードに置いてきぼりにされてしまいます。

（つまりコードとコメントの整合性が取れなくなる。）

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