Purpose

• set ignore-module-all for autodoc_default_options to resolve some Sphinx errors about duplicate / ambiguous references more than one target found for cross reference should prefer current file's method over other libraries methods sphinx-doc/sphinx#4961 (comment)
• Standardize some non-standard (Google-ish) docstrings to Sphinx format, to avoid ruff and Sphinx arguing about underline length.
• Fix indents and other minor whitespace / formatting changes.

Fixes #1029

Rationale

Happy to do this differently, but Sphinx style seemed to match most of what we had in the codebase

Pros:

• Types are inferred automagically
• A bit easier for machine parsing
• Slightly smaller footprint

Cons:

• A bit harder to read directly in the code (no types, etc.)
• No ruff support for setting pydocstyle to sphinx.

How did you test?

Generated locally and spot-checked that at least type inferences etc. seemed to work Ok.

Note: references to errors raised / types from other libraries aren't automagically linked; I assume that's Ok.

How to Verify

Build docs following docs in contributing guidelines, and view in browser