I would like to show you how you could extend your javadoc to include samples directly into the javadoc without extra work.
What I don't like about javadoc is the lack of code sample. Something is can be hard to find the starting point of a new framework.
Let's show a example, it will be easier to understand, and so simple.
[prettify] /** * * This in a javadoc with...