>>728
馬鹿ハケーン！！

IDEでリファクタリングするならJavadocもリファクタリングされるぞ。
@paramタグもそうだし、{@link}とか@throwsとかもそう。

当然リファクタリングでは動作は変わらない。
だからJavadoc内の説明文章なんて変える必要ないだろ。

リファクタリングで変わって欲しいのは、
　/**
　　* {@link xx.xx.XXX}のインスタンスを・・・します。
　　* @param yyyy
　　*/
の@linkと@paramだけだ。
リファクタリングで「のインスタンスを・・・します。」が変わる必要ないだろ。
動作は変わらないんだから。
変われば、それは仕様変更というもの。リファクタリングではない。

Javadocは動作・仕様を明記する場所だぞ。
コードを書くときは考えながら書くにしても、
当然書く前から何をすべきかは決まっている。
つまり、先にJavadocを書けるわけだ。

Javadocを後に書くということは、よっぽど面倒か、
設計能力がないだけ。つまり>>728はアホ確定。
だからユーザが育たないフレームワークと言われるんだよ。