In some situations, the reluctance to use Javadoc might stem from feeling like the Javadoc documentation is repetitive of the code itself or of other external documentation.

2. Documenting Use of an API (Java SE, Java EE, Guava, Joda Time) When learning how to use a new API, it is helpful when the Javadoc documentation provides examples of using that API. I first ...