I came across an interesting blog entry today (see URL reference) that refers to a Sun Java tech tip for generating custom taglets. The example shows linking to Javapedia page for examples. This is slick and deserves some attention, I think. Having javadoc web pages point to examples that are community created is great. In fact, I like this idea so much that I think I'll borrow it for the work I'm doing with XDoclet generation of Ant task documentation. We've struggled a little to find a way to integrate example usage of Ant tasks into the documentation that will be automatically generated - should it be embedded in the source code? should there be an external file that gets pulled into the generated artifacts? Better yet, put examples on a wiki and let the community evolve it, yet link to the wiki pages directly from the official documentation.... yes, I like it!