Update readme and add docs to CONTRIBUTING.md
Update javadoc