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