That's for code.  We have a different set of guidelines for Javadocs that are currently only on the wiki(http://wiki.bukkit.org/Getting_Involved).  They will be added to CONTRIBUTING.md sometime in the future.