osatohh https://blog.hatena.ne.jp/osatohh/ おさとの雑記帳 https://osatoh.com/ 本 コメントすべきでないこと、すべきなこと コメントの目的とはなんでしょうか？ それは書き手の意図を読み手に知らせることです。 ただし、全ての意図をコメントすればいいわけではありません。 コメントを読むということはその分だけコードを読む時間が減るので、書くならばコードを読むより価値がある必要があります。 以下ではコメントすべきでないこと、すべきことを見ていきます。 コメントすべきでないこと コードからすぐにわかることを書かない 例えば以下のようなコメントが該当しそうです。 # 引数を二つ与えて、その合計を返す関数 def total(a, b) a + b end total(2, 5) #=> … 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fosatoh.com%2Fentry%2F2022%2F10%2F12%2F120000" title="【リーダブルコード】第五章 コメントすべきことを知る の要約 - おさとの雑記帳" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> Hatena Blog https://hatena.blog 2022-10-12 12:00:00 rich https://osatoh.com/entry/2022/10/12/120000 1.0 100%