Cleaning up the docs... again

[john-science]

What is the change?

Misc changes to docs and tests.

Why is the change being made?

Reviewers have asked for doc changes.

---

Checklist

• This PR has only one purpose or idea.
• Tests have been added/updated to verify that the new/changed code works.

• The code style follows good practices.
• The commit message(s) follow good practices.

• The release notes (location doc/release/0.X.rst) are up-to-date with any important changes.
• The documentation is still up-to-date in the doc folder.
• If any requirements were affected, mention it in the release notes.
• The dependencies are still up-to-date in pyproject.toml.