Structure JavaDoc of Classes and Interfaces
"Structure JavaDoc of Classes and Interfaces" is one of the 70 comparisons in the book Java by Comparison: Chapter 3: Use Comments Wisely, pages 52–53.
Like every item in the book, it shows a piece of flawed Java code on one page and the improved version on the next, and explains why the improvement is better.
