回答編集履歴

  > 運営メンバーSさんがコードレビューで重視しているポイントは「コメントの質と量」でした！

 

  クラス・関数・メソッドの仕様を、（各言語の一般的な形で）冒頭コメントに書くルールにするのはもちろん良いのですが、処理部分のコメントについての話です。「コメント書いたら今後ずっと二重メンテ必須」なので。

 

  例えば、「トリッキーなことをしてコードを短くして、その説明コメントを丁寧に書く」なら「多少長くても簡明なコードを書く」ほうが良いと思います。そこが速度のボトルネックで性能チューニング意図なら別ですが。