Javaで非推奨のクラスにコメントする最良の方法は何ですか？

Javaで非推奨のクラスを識別するためのコメントを追加する最良の方法を知りたいです。クラスの先頭に追加された以前のコメントを削除して、別のプログラマーがそのクラスの目的を理解できるようにするか、コメントの下に追加する必要がありますか？

Javaでクラス、メソッド、またはフィールドを非推奨にするための推奨されるアプローチは@Deprecated、Java 5で使用可能になった注釈、または@deprecatedJava 1.1以降に使用されているJavaDocタグを使用することです。Oracleには、関連があると思われるAPIを非推奨にする方法と時期に関する詳細についてのドキュメントがあります。

クラスの先頭に追加された以前のコメントを削除して、別のプログラマーがそのクラスの目的を知るのに役立つようにするか、コメントの下に追加する必要がありますか？

JavaDocタグまたは注釈を追加する場合を除き、既存のコメントを編集または削除しないでください。廃止されたコードは依然としてレガシーシステムで使用されている可能性があり、それらのシステムの開発者は、元の開発者が何らかの形で行ったドキュメントにアクセスする必要があります。