Existing javadocs should not be changed (in general) in a PR, that's what Bukkit-Javadoc is for.