DM-39803: Cleanup docs for Sphinx nitpick mode

[timj]

Checklist

• ran Jenkins
• added a release note for user-visible changes to doc/changes

[codecov]

Codecov Report

Patch coverage: 100.00% and no project coverage change.

Comparison is base (3943c6b) 93.95% compared to head (7f638f2) 93.95%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #163   +/-   ##
=======================================
  Coverage   93.95%   93.95%           
=======================================
  Files          43       43           
  Lines        2830     2831    +1     
=======================================
+ Hits         2659     2660    +1     
  Misses        171      171           

Impacted Files	Coverage Δ
python/lsst/utils/iteration.py	96.96% <ø> (ø)
python/lsst/utils/logging.py	91.07% <ø> (ø)
python/lsst/utils/packages.py	89.89% <ø> (ø)
python/lsst/utils/timer.py	99.26% <100.00%> (+<0.01%)	⬆️

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[jonathansick]

Looks good.