google-code-prettify

2008-07-22

ソースコードのコメントに書くべき事

ソースコードは、何をしているかは(ある程度)表す事ができるが、以下の点は表現する事ができない。
・なぜそうしているか。
・他の選択肢には何があったか。なぜそれらではダメなのか。
・どういった思想で作っているのか。

これらの点はコメントとして記述するべき。

0 件のコメント: