Cleanup and expand Java Docs in the repo

[iamgollum]

Observation

• There are TODOs that can be removed / covered by existing Issues.
• There is a lack of docs on the classes and methods to explain what is going on

Action Item

Assess and clean up repo