Javadoc additions

Some javadoc additions to improve code quality