Fix #8287

Proposed fix for #8287. 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