docs: fix all remaining docstring RST formatting for Sphinx/docutils compliance

[jaelliot]

Summary

Completes the docstring RST cleanup started in wave-1 PRs (#137-#147). After this PR, make -C docs html builds with 0 warnings and 0 errors (clean from 303+ errors on upstream main).

Changes

Python source docstrings (30 files)

• Fix unexpected-indentation errors by converting free-form text blocks to proper RST list items and explicit literal blocks
• Fix inline markup issues (unclosed *, malformed ``)
• Minor typo fixes (converstion → conversion, accomodate → accommodate)

Sphinx configuration (docs/source/conf.py)

• Expand autoapi_dirs from base/ only to the full hio package (all modules now covered)
• Guard sphinx.ext.viewcode behind sys.version_info < (3, 14) to fix a crash in Python 3.14
• Remove undoc-members from autoapi options (reduces noise)
• Add test.md to exclude_patterns

Manual RST pages (docs/source/hio.*.rst)

• Add :no-index: directives to manually-documented modules to resolve duplicate-object-description warnings when autoapi covers the same symbols

README.md

• Minor line-wrap cleanup (no content change)

Verification

make -C docs clean && make -C docs html
# Build output: 0 warnings, 0 errors
# "build succeeded."

pytest tests/base/test_doing.py tests/base/test_tyming.py tests/base/test_multidoing.py -q
# 32 passed

Pre-existing failures unrelated to this PR:

• tests/base/test_filing.py::test_filing — path assertion against installed package (fails on main too)
• tests/core/memo/test_memoing.py — missing MemoerVerifyError in installed package
• tests/help/test_timing.py — missing AsyncTimer in installed package

[jaelliot]

This PR appears to be the consolidated follow-up for the earlier split docfmt/docs cleanup PRs. I verified that its file set subsumes the work from #143 and #148-#153, so this is the main HIO docs/docstring cleanup branch to review for the current pass.

For queue hygiene, I’m closing the superseded split PRs and leaving this one open as the aggregate review target.

[SmithSamuelM]

This now has conflicts after merged earlier pull requrests. Maybe I misunderstood the order. I merged the oldest ones first.

[jaelliot]

Rebased onto current main (which now includes the merged split PRs #143, #148–#153). Conflicts resolved — force-pushed c5f9af1.

After rebase, the net diff is 11 files / 214 ins / 305 del (down from 39 files originally, since the split PRs already landed the rest).

Verified locally:

• make -C docs clean && make -C docs html → 0 warnings, 0 errors
• pytest tests/base/test_doing.py tests/base/test_tyming.py tests/base/test_multidoing.py -q → 31 passed

Ready for review again.

[jaelliot]

Queue note after re-checking the three open HIO PRs:

• #154 is the active aggregate review target and is currently mergeable clean.
• #152 is now conflict-dirty but its file set is fully subsumed by #154, so I am treating it as superseded unless you want something split back out.
• #133 is also conflict-dirty, and against current main it has drifted well beyond the original 5-file scope in the PR body. If any of its doing.py / acting.py docstring work is still wanted, the clean path is a fresh minimal follow-up from current main, not rebasing the existing branch.

So from my side, #154 is the one to review/merge for the current docs/docstring cleanup pass.

[SmithSamuelM]

I merged this one $154 so if the other two are obsolete please close them Thanks