Для функций, которые не изменяют состояние экземпляра, комментарий javadoc для метода часто совпадает или очень похож на комментарий для тега @return-в Java-АПИ.
boolean Collection.isEmpty()
Теперь я пишу javadoc для многих простых методов, таких как getExpression(), где у меня та же проблема. Должен ли я сделать это как в API или оставить его?