ネタ元 → 好き嫌いシリーズ - コメント
コメント...書きませんねぇ、極力書かない。
書くとしても // 一行コメント ばっかしです。
あるいは
/*
* 大きなブロックに対し、何を意図しているか、
* なぜこうしたか、なぜそうしなかったか、
* など、コードからは読み取り辛いことを
* こんなフォーマットで書きます。
*/
説明のためにせっせとコメント書いてる暇があるなら
説明不要なコードを目指したいっす。
適切な名前を与え、理路整然としたコード書けば
"何をどうする"かは十分伝わると思うですよ。
伝わらなさげなら要所要所に // 一行コメント 貼っとけばいいさ。
僕が怖いのはコメントが嘘をつくことがあること。
それとコメントが読み手のコード読む気をそぐ恐れ。
「ヒトが読むことを考えてコード書け」には同意するけども
それすなわち「コメントまみれにしろ」じゃないしね。
コメントなしで理解してもらえるのが上策と考えます。
...極度のめんどくさがり屋だからなんですけどね。