And this is wrong since only the impl package does not have method level javadoc what is compliant to what we agreed on. *.impl.* and *.*Impl do not need to have method level javadoc. That is also what the XML comment said.