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.
/**
*
* This in a javadoc with a custom tag @example.
*
* @...
