TL;DR メソッドや変数を説明するコメントを、シンプルかつ完全に書くのが難しいこと。レッドフラグの 1 つである。 なぜ必要か メソッドや変数を説明するコメントは、シンプルでありながら完全であるべきである。そのようなコメントを書くのが難しい場合、設計自体に問題がある可能性が高い。 関連 レッドフラグ 名前を付けるのが難しい