Adopt NumPy doc-string style guide

[bjlittle]

See

• https://numpydoc.readthedocs.io/en/latest/format.html
• https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html

[github-actions]

In order to maintain a backlog of relevant issues, we automatically label them as stale after 500 days of inactivity.

If this issue is still important to you, then please comment on this issue and the stale label will be removed.

Otherwise this issue will be automatically closed in 28 days time.