So as you may have already noticed, I like to write a lot. This carries over to documentation, and I prefer javadocs when it comes to that as it's far easier to keep in sync with how the code works. With that in mind, I've been elaborating about random classes to help improve the docs. However, since I'm obviously not the author of everything here by any means, I might misinterpret classes or functions slightly. If I do, please let me know!
As a developer, I usually skip straight to the javadocs for any library I use, and I'm oftentimes disappointed by the lack of documentation in them. Examples can become stale over time. A good majority of the JDK is well documented (there are several exceptions of course), and I like to try to follow that pattern myself. -- Matt Sicker <[email protected]>
