読んだもの

ここ数カ月で読んだものの中から。

リーダブルコード

リーダブルコード ―より良いコードを書くためのシンプルで実践的なテクニック (Theory in practice)

コードを書く上でのお作法のようなものを読み易さに重点を置いてまとめてる。
レビューをこの本のような基準で行うと良いかも。

コメントについての「自分の考えを記録する」は参考になった。以下引用。

// 合理的な限界値。人間はこんなに読めない。 
const int MAX_RSS_SUBSCRIPTIONS = 1000;

つまり思ったことを書くのは有益とあるため、
以下のようなコメントも書くべきなのかも。
（※ 回りくどいしコードを直すべきなので有り得ません）

/*
（聞こえますか……聞こえますか……
ソースコードに直接コメントしています……
このコードは役割が多すぎてヤバいです……）
*/