Skip to content

docs: clarify JSON media type defaults and strict migration - #605

Merged
yeongseon merged 2 commits into
mainfrom
docs/json-content-type-contract
Oct 26, 2026
Merged

yeongseon merged 2 commits into
mainfrom
docs/json-content-type-contract

Conversation

@yeongseon

Copy link
Copy Markdown
Owner

Summary

Make strict JSON Content-Type configuration obvious without changing compatibility defaults.

Changes

Document application/json and structured +json acceptance, text/plain and missing-header behavior, non-empty 415 and empty-body 422 outcomes. Expand relaxed-default coverage across all four header classes. Describe client-first per-route migration and require a separate breaking-release decision before changing defaults; no warning or vulnerability claim is introduced.

Validation

Python 3.11 make format check-all build passed: 767 passed, 27 deselected, 4 warnings in 19.84s; coverage 97.16%. Existing strict Content-Type cases pass. No production behavior change. GitHub CI pending.

Related Issues

Closes #597

Merge authorized by the maintainer’s explicit instruction.

@yeongseon

Copy link
Copy Markdown
Owner Author

Merge authorized by the maintainer’s explicit instruction. Reviewed documentation against body policy tests; no default change. Exact head 60dfada: all five required contexts completed=success; no unresolved review threads. Local make check-all build: 767 passed, 27 deselected, 4 warnings in 19.84s; 97.16% coverage.

@yeongseon
yeongseon merged commit 283bcca into main Oct 26, 2026
25 checks passed
@yeongseon
yeongseon deleted the docs/json-content-type-contract branch October 26, 2026 14:25
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.

docs(security): state JSON Content-Type behavior and migration choices

1 participant