ENGINE-1822: improve javadoc