ソースにコメント

とりあえず書く元になったネタから。
http://d.hatena.ne.jp/ABA/20040623
それについてのコメントで、

ABA 『コメントを書かなければならないようなコードを書いたら負け、っていう考えですかね。でも熟練者から初心者までみなに広く理解可能なコードを書くのは難しいから、やっぱりある程度はコメント必要かと。』

これを読んで、「はて？ボクは今書いてるソースに対して、何のためにコメント書いてるんだっけ？」と考えてしまいましたよ。
ボクはソースにコメントを書く時に、ある程度は「これを読む他人のため」に書いてはいますが、実はわりと「未来の自分のため」に書いたりしてます。なんで、書いている内容とかが「自分向け」だったりしてるんですよねー。
そもそも、「何のために」コメントをつけるのか？という話になってくるんですけど、理想は「一見して何か解らない変数や値や処理」に対して書くのかなー？でも、「一見して解らない」それらの物を書いた時点で負け、ってことになりますしね。
カーニハン氏著の「プログラミング作法」には確か、例として「ソースを引用した出典」とか「その関数のテストに利用した値」とか、「具体的な性能の数値」とかを書いたコメントを例として挙げてたような気がしますが、今手元にその本が無いので確証が持てません。ごめんなさい。
そもそも、「初心者に対してのコメント」と「それ以上の人に対してのコメント」というのは、性質が違うような気がする。前者が「教本的」なのに対して、後者が「実用的」とでも言ったら良いのだろうか？いや、まあ、あたりまえか。
間違い無く言えるのは、今のボクがつけているコメントは、あまりにも「自己中心的」なコメントということだ。そんなやつがしたり顔でこんなこと書くなよ。