javadoc method guidelines updated