Removes old README and adds small changes

Title is outdated - The old README was a local issue and was not present upstream.

This PR simplys adds some small code and JavaDoc changes.