Updating javadoc based on PR feedback