Created by: cvrebert
Proposed fix for #8287 (closed). This definitely warrants some proofreading. I repeated the warning for popovers since folks seem to not understand/remember that they're based on tooltips.
/cc @juthilo if you happen to be interested, since you contributed that other nice docs patch recently