Add parameter description for all constructors
Improve description of in place caching across the board
Use internal links to setId in the Javadocs