Extend JavaDoc in Shorthand

[jvdb]

Goal is to further improve IDE experience, ideally with for ever item:

1. An explanation of the concept of the object(s) it instantiates.
2. Some information about which specific building blocks are used for this.
3. Links to the (overloaded) methods it uses.