最近、会社でリーダブルコードを輪読したり、Fukuoka.rb で Eloquent Ruby を読んだりしていて、メソッドや変数名の長さやコメントについての議論を読む機会があった。 昨日、たまたま 37signals のブログを読んでいたら、Rails の作者である David Heinemeier Hansson もこのトピックについて書いていた。 自分は WEB+DB PRESS で ukstudio さんの書いた RSpec についての記事を読んで感化されて以来、ソースコード中のコメントはすべて悪で、はっきりしたメソッド名、変数名を使えばコメントはいらないという考え方を持っている。DHH もそのような考え方のようだ。 要点をかいつまむ。 多くのプログラマーは短い変数名やメソッド名を好む。短い命名は明確性や簡潔性を犠牲にしているとみんな気づいてるんじゃないかと疑ってるんだけど、実際の
![コメントが多いコードはダメなコードだと思う - portal shit!](https://cdn-ak-scissors.b.st-hatena.com/image/square/a01034cd7c260e3e21a9e02e2508fd6843bf4638/height=288;version=1;width=512/https%3A%2F%2Fportalshit.net%2Fog-image%2Fcode-with-a-lot-of-comments-smells-og-image.jpeg)