Note that we want frontend review on the docs changes.

Created by: Joelkw

Inspired by Felix's comment here, after discovering a bad docs pattern that someone introduced and others (including myself) had been copying around.