JavaDoc

個人的には JavaDoc は書く。
Java なら JavaDoc、Perl なら pod をできるだけ書く。

一生、自分しか触らない・読まないコードであるならば、必要ないかもしれないけど、
だれかが読んだり、修正したりするコードならば、絶対あったほうが良いなぁと思う。

自分の場合、たとえ自分しか触らない・読まないだろうコードであっても、
数ヶ月後には、自分でもわからなくなっていることがあるので。。。書く。

そのほうがずっと「やさしい」んじゃないかなぁと思ったりします。