4784198 : Java API Documentation needs to include class diagrams
Name: gm110360 Date: 11/25/2002
FULL PRODUCT VERSION :
A DESCRIPTION OF THE PROBLEM :
The Java standard libraries are ever expanding. The Javadoc
generated API documentation is helpful but becomes difficult
to survey. A new kind of information compression is necessary.
Class diagrams could be up to this job.
To be really useful these diagrams should be created by humans
and included in the HTML-documentation. The various elements
in the diagram should link to the normal API specifications.
This bug can be reproduced always.
CUSTOMER WORKAROUND :
Class diagrams for JDK 1.4 that illustrate the concept
are found at www.falkhausen.de/en/index.html
(Review ID: 178316)
The work at falkhausen.de would be an enormous amount
of work for us to reproduce. Since that work is already done, it seems
better to simply point to that work, perhaps from our docs page and javadoc
###@###.### 2004-12-16 23:30:10 GMT