By bloid
via blogs.sun.com
Published: Aug 11 2008 / 06:25
Java's API documentation hasn't changed much since the mid-90s and it's starting to show. There are a lot of good reasons for the slow pace of change, but it certainly gets annoying. When we started developing JavaFX we set out to make some serious changes to the platform, and API documentation was part of that. The JavaFX SDK ships with a new documentation tool creatively named javafxdoc. My initial suggestion was AwesomeDocs 5000, but sadly that was turned down by the trademark lawyers. Despite the pedestrian name, however, it remains awesome. Go check it out here.
Comments
trevor replied ago:
I up-voted the article. However the first thing I did was try to search for a class. Guess what? The search failed because the class name was hidden in the accordion list. What am I supposed to do if I don't remember the package name? Unless there is a searchable index or some similar feature that wasn't mentioned in the article, the docs are now practically useless. They look pretty though.
Voters For This Link (9)
Voters Against This Link (0)