you could enhance this javadoc with the explanation you gave for this PR