Fix documentation build warnings

[glatterf42]

Closes #758. This PR addresses some of the docs-build process errors described in that issue. See there for more details.

How to review

• Read the diff and note that the CI checks all pass.
• Check the RTD-built documentation and check the warnings/that they don't bother us (generally on the api, reporting, and macro pages)

PR checklist

• Continuous integration checks all ✅
• [ ] Add or expand tests; coverage checks both ✅ No functionality changes.
• Add, expand, or update documentation.
• [ ] Update release notes. No user-facing changes.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.3%. Comparing base (f360dc7) to head (8cc2c58).
⚠️ Report is 627 commits behind head on main.

Additional details and impacted files

@@          Coverage Diff          @@
##            main    #759   +/-   ##
=====================================
  Coverage   94.3%   94.3%           
=====================================
  Files         43      43           
  Lines       3474    3474           
=====================================
  Hits        3279    3279           
  Misses       195     195