オーバーロードメソッドでJavadocを書き込むDRY方法

JavadocをDRYで記述したい。しかし、Javadocに関するOracleのドキュメントでは、オーバーロードメソッドのコメントに同じことを再度記述しています。繰り返しは避けられませんか？

{@inheritDoc}スーパークラスからメソッドをオーバーライドしたり、インターフェース定義のメソッドを実装したりするときは、Javadocコメントのあちこちにディレクティブを振りかけます。

これは少なくとも私にとってはうまく機能し、ソースコードでの繰り返しを回避します。必要に応じて、特定の情報を特定のJavadocコメントに追加できます。適切なIDEで必要なのは、関連付けられた識別子名にカーソルを合わせるだけで、レンダリングされたJavadocに参照などを表示する場合、Javadocコメント自体が問題になることはないと思います。

ドキュメント化のポイントは、アイテムの将来のユーザーを明らかにすることです。これは、部分的には作者の便宜のためです。そのため、誰かが事がどのように機能するかを理解できない場合は、彼または彼女に連絡する必要はありません。しかし、ほとんどの場合、それを使用またはサポートする必要がある人々の利益のためです。

そのため、著者にとっての便宜とは対照的に、ポイントは明快でなければなりません。あなたは本質的に怠惰で自分自身を繰り返すことができなかったので、人々があなたのAPIドキュメントを探し回るのを期待することはできません。それを吸ってください--Javadocは繰り返しになります。

とは言っても、理由はありません。賢いのであれば、マーカーやその他の基準に基づいてコードにコメントを貼り付けるプログラムを作成することはできません。それは価値があるよりももっと面倒かもしれません。か否か。