Description

These doc changes are pulled out of PR #222, which was easy now that basically everything else is already merged.

How has this been tested?

Self review of code.

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
  (changed docstrings)
• I have made corresponding changes to the documentation
  (this will automatically feed into nicer auto-docs)
• My changes generate no new warnings
• Any dependent changes have been merged and published in downstream modules: N/A
• New check tests, if applicable, are included: N/A