退化コメントになっていないか
開発が進むにつれて元あったコメントは更新されずに退化していくことが多い。コメントは劣化コピーに過ぎないことを理解しよう。
ロジック更新時にコメントも更新したか
可読性の悪いロジックを捕捉説明するようなコメントを書いていないか
上述の通り、コメントは退化しやすい。メソッド名を改善しよう。
ロジックの意図や仕様変更時の注意点をコメントしたか
ドキュメントコメントを使用しているか
YARD,RDocなどrubyでもドキュメントコメントを使用できる。
https://qiita.com/kmats@github/items/0c8919a65afbe18e9e37