Skip to content

docs: close deep-audit documentation-accuracy findings#66

Merged
lesnik512 merged 1 commit into
mainfrom
docs/audit-doc-fixes
Jun 14, 2026
Merged

docs: close deep-audit documentation-accuracy findings#66
lesnik512 merged 1 commit into
mainfrom
docs/audit-doc-fixes

Conversation

@lesnik512

Copy link
Copy Markdown
Member

Summary

Closes the remaining confirmed documentation-accuracy findings from the 2026-06-14 deep audit.

Finding Fix
M4 architecture/client.md streaming section omitted Client.stream() → documents both sync + async stream()
L13 architecture/client.md misattributed the httpx2.*.send call to Client.send/AsyncClient.send → corrected to the internal _terminal (.send() enters the chain first)
Nit4 errors.py docstring named only AsyncClient's terminal as the auto-raise site → now lists all four (both terminals + both stream())
Nit15 architecture/extras.md showed pydantic>=2 without the <3.0 ceiling → synced to pydantic>=2.0,<3.0
Nit14 docs/middleware.md + recipes/phase-decorator-patterns.md imported root-__all__ symbols via submodule paths → standardized to from httpware import X

(Nit2 — the _is_streaming_body_async reliance note — is moot: #64 symmetrized the code instead of documenting the reliance.)

This is the final batch of the deep-audit remediation (after #62, #63, #64, #65).

Test plan

  • just lint-ci clean (CI-exact); just test — 656 passed, 100% coverage
  • Doc/docstring-only — no behavior change

🤖 Generated with Claude Code

- architecture/client.md: document Client.stream() alongside AsyncClient.stream()
  (M4); attribute the httpx2 send to the internal _terminal, not .send() (L13).
- errors.py docstring: list all four auto-raise sites, not just AsyncClient's
  terminal (Nit4).
- architecture/extras.md: sync the pydantic constraint to >=2.0,<3.0 (Nit15).
- docs/middleware.md + recipes/phase-decorator-patterns.md: import root-__all__
  symbols via `from httpware import X` (Nit14).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lesnik512 lesnik512 merged commit daf6ac3 into main Jun 14, 2026
5 checks passed
@lesnik512 lesnik512 deleted the docs/audit-doc-fixes branch June 14, 2026 14:21
lesnik512 added a commit that referenced this pull request Jun 14, 2026
All 35 confirmed 2026-06-14 deep-audit findings are remediated across
#62-#66. Promote the four remaining bundles (deep-audit umbrella +
correctness/test-quality/doc-fixes) to changes/archive/ with status:
shipped, pr, and outcome filled; Active is now empty.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
lesnik512 added a commit that referenced this pull request Jun 14, 2026
Add 0.11.0 release notes (security redaction, bounded error bodies +
ResponseTooLargeError, correctness fixes, middleware __all__, test/doc
quality — the full 2026-06-14 deep-audit remediation, #62#66).

Reset the static pyproject version to the placeholder "0": releases are
tag-driven (publish.yml runs `uv version $GITHUB_REF_NAME` from the tag),
so the field was stale at 0.3.0 against the 0.10.1 release history.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant