Summary

• New audit: planning/audits/2026-07-13-docs-comments-audit.md — first pass covering source docstrings/comments (src/httpware/**) and architecture/** directly (the 2026-06-13 audit only covered user-facing docs//README).
• Fixes the 4 mechanical findings (C1, C2, I1, I4), tracked in planning/changes/2026-07-13.07-docs-comments-audit-fixes.md:
  • BulkheadFullError docstring named AsyncBulkhead specifically, though both Bulkhead and AsyncBulkhead raise it.
  • AsyncClient.stream()'s "for v1" caveat contradicted the sync docstring and architecture/client.md (which states the middleware bypass as permanent, not version-scoped).
  • architecture/errors.md said DecodeError wrapping happens inline in Client.send/AsyncClient.send; it actually happens in _BoundDecoder.decode (decoders/_resolver.py), matching architecture/decoders.md.
  • docs/testing.md said "httpx" where every other reference (including architecture/testing.md) says httpx2 — a distinct package, not an alias.
• Remaining findings (I2/I3 policy-wording contradictions, D1/D2/D3 doc duplication/compaction candidates) are deferred in the audit, pending a maintainer call on wording direction.

Test plan

• just lint-ci — clean
• uvx --with-requirements docs/requirements.txt mkdocs build --strict — clean
• just test — 780 passed, 100% coverage
• just check-planning — OK