プログラムのコメントに『何をしているコードか』を書いても無意味なので、代わりに『なぜそのようなコードになったのか』を書くようにしよう

タイトルで全部言い切ってしまいましたので、後は冗長に書いてブログエントリーに仕立てます。　職業上、プログラムを毎日観ていていますが、一番多いコメントが『何をしているコードか』というものです。「ここでトランザクションを開始する」「もしEOFだったらファイルを閉じる」「セミコロンで分割して最初の文字を取得する」などなど……　それって、要ります？？　構造や内容については、その言語が読める人なら誰でも解る...

記事全文を読む