refactor javadocs