Idea: can we lay this out in the same style as the api docstrings? We won't run sphinx against it, but consistent formatting will make it easier to visually parse.

@talbs is this an ad-hoc format, or one that the UX team uses consistently? Would changing these layouts make you a sad panda?