DATACMNS-525 - Add reference Documentation

The documentation still needs to be linked into the main file
DATACMNS-525 - Cleanup round II.

Updated Javadoc.
Added issue comments.