Почему джавадоки злы и что является лучшей альтернативой?

Question

Недавно я отправился на собеседование, и мне было предложено представить пример моего производственного кода.

Представлен код в комплекте с javadocs, но был допрошен интервьюером о моем выборе.

Я нахожу, что javadocs весьма полезны для понимания кода другими, и на самом деле это не такая уж большая проблема с четкостью, если я использую IDE. Может ли кто-нибудь просветить меня, почему он не может быть рекомендован, и что было бы лучшей альтернативой в указанной ситуации?

Answer 1

Javadocs являются не зла, и для Java это лучше вы можете сделать, чтобы должным образом документировать свой код.

Под вопросом не означает автоматически, что то, что вы сделали, является злом. Вопросы в основном проверяются, если вы уверены в том, что делаете, и если вы знаете об этом больше или вы только что догадались.