リーダブルコードを読みました - ぐだぐだ言ってないでコードを書けよ、ハゲ。

素晴らしい本だった！！
印象に残ったところを中心にまとめておく。

大事なことなので二回言いました。

下のコードでは誤解が生じる。

引数の単位は何だろう？
秒？ミリ秒？

実装を読めばわかるだろうけど、そうしなくてもいいようにすべきだ。

単位が明らかになった。

どれくらいの抽象度で書くべきかは都度判断するしかない。

下のコードでは2通りの解釈が生まれてしまう。

これはよくない。
曖昧さを残さない名前をつける必要がある。

これならば解釈の違いは生まれない。

こういうテストは書くべきではない。

テストコードはプロダクト自体のコードと比べて雑に扱いがち。
さほど複雑でないメソッドのテストならなおさら。
上のコードのように一つのメソッドに詰め込んでしまうこともある。

でも大抵の場合、複雑さは後々増していく。
後でテストコードを追うのは至難のワザ。なので初めからテストコードが想定する状況を名前に書くようにするのがベター。

自分以外の誰かがメンテナンスする場合にこの基準に合わせてコードを書いてくれることも期待できる。

気軽に読める分量で、この本自体がリーダブル。
Kindle 版がないのが唯一の不満。

プログラマーならば必読といっていい。
デブサミの技術書大賞にあがったのもうなずけた。