Related link: http://getahead.ltd.uk/doctree/
I’ve been programming in Java for years, and JavaDoc is
still a real pain. I’ve got a whole collection of bookmarks to the JavaDoc I use - namely J2SE 5, Hibernate 3, Spring 1.2, and various Jakarta Commons JavaDoc pages. When I really need to refer to some JavaDoc, I almost never have it loaded and I have to rifle through a huge alphabetical list of classes. Ick. I know there are better ways….
Anyone know of any other useful JavaDoc aggregation sites out there?
And, I’ve found one over at the DWR - Direct Web Remoting project. Take a look at DocTree for an aggregation of JavaDoc from 110 projects containing over 32k classes. This app does for JavaDoc what the ibilio Maven repository does for managing external dependencies. Now, instead of searching for a link to yet another JavaDoc API, I’ll fire this app up and click away. The links from DocTree still point to the JavaDoc on each project’s site, but the DWR project has gone to the trouble of putting it all in one place. This doesn’t address the fact that JavaDoc is still a nasty documentation format, but it is a step in the right direction.
BTW, I know. I’ll eat my own words on AJAX. I said some nasty things about it a while back, but I was recovering from some exposure to some seriously bad AJAX implementations. AJAX does make sense, but only in the context of frameworks like Prototype or DWR. I’m a stubborn old hack, but I’ll correct bad calls when they happen.