Нередко встречаются расхождения между разными версиями документации.Большинство разработчиков рассматривают документацию как рутинную работу, и они, как правило, откладывают ее.
Как правило, если javadoc говорит что-то одно, а некоторая документация, не относящаяся к javadoc, противоречит этому, есть вероятность, что javadocболее точным.Программисты, скорее всего, будут поддерживать Javadoc в актуальном состоянии, внося изменения в код ... потому что "источник" для Javadoc находится в том же файле, что и код.
В случае тегов @deprecated
Это виртуальная уверенность, что Javadoc является более точным.Разработчики осуждают вещи после тщательного рассмотрения ... и (вообще говоря) они не обесценивают их.