cleaner doc, more obvious examples (JBIDE-15892-JBIDE-15891)