[misc]技術者の評価を下げる「悪い」コメントに注意しよう

http://www.aerith.net/design/comment-j.html
確かにいる。こういう人。特に「嘘」は痛いよなぁ。カット&ペーストが原因ではあるんだけど。JavaDocで引数の数とか、型とかある程度はチェックできるけど、それ以上は無理だからなぁ。。
JavaDoc中にある自分たちでつける変数名とかを整合性がつけれるといいのになぁ。たとえば、

  • 「index」、「offset」などメソッド中の引数で共通の意味を持たなかったら警告を出す。

とか。