PR summary

In a couple cases, these are probably supposed to be code blocks, so swap : to :: (or add the latter.)

Otherwise, for simplicity, I only dedented everything as necessary (i.e., no re-wrapping,) in order to produce a simpler diff. Thus is should be possible to view the diff with whitespace ignored and see very few changes.

PR checklist

• [n/a] "closes #0000" is in the body of the PR description to link the related issue
• [n/a] new and changed code is tested
• [n/a] Plotting related features are demonstrated in an example
• [n/a] New Features and API Changes are noted with a directive and release note
• Documentation complies with general and docstring guidelines