javadoc in-sync with the guide