Hi Aleksej, > I don't know, you tell me -- you have the tools that enforce > @since-ness! Certainly, we can put @since on classes only, if that is > acceptable.
I don't have such tools. But when I write JavaDocs I try to follow the recommendations from this article: http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html And here is the excerpt from the article regarding the @since tag: When a class (or interface) is introduced, specify one @since tag in its class description and no @since tags in the members. Add an @since tag only to members added in a later version than the class. This minimizes the number of @since tags. Best regards, Andrej Golovnin
