Jaki jest najlepszy sposób skomentowania przestarzałej klasy w Javie?

Chciałbym poznać najlepszy sposób dodania komentarza w celu zidentyfikowania przestarzałej klasy w Javie. Czy powinienem usunąć poprzedni komentarz dodany na początku klasy, który pomaga innemu programistowi dowiedzieć się, do czego służy ta klasa, czy powinienem dodać go pod komentarzem?

Zalecanym podejściem do zastępowania klasy, metody lub pola w Javie jest użycie @Deprecatedadnotacji, która stała się dostępna w Javie 5, lub @deprecatedznacznika JavaDoc, który istnieje już od Java 1.1. Oracle ma dokument na temat szczegółów, w jaki sposób i kiedy należy wycofywać interfejsy API, które wydają się istotne.

Czy powinienem usunąć poprzedni komentarz dodany na początku klasy, który pomaga innemu programistowi dowiedzieć się, do czego była ta klasa, czy dodać go pod komentarzem?

Nie należy edytować ani usuwać żadnych istniejących komentarzy poza dodaniem znacznika JavaDoc lub adnotacji. Przestarzały kod może być nadal używany w starszych systemach, a programiści tych systemów muszą mieć dostęp do dokumentacji, którą zrobili pierwotni programiści w jakiejś formie.