Skip to content

[Website] Document the 16.7 response format selection changes - #10459

Merged
glen-84 merged 1 commit into
mainfrom
gai/migration-guide-format-selection
Oct 1, 2026
Merged

glen-84 merged 1 commit into
mainfrom
gai/migration-guide-format-selection

Conversation

@glen-84

@glen-84 glen-84 commented Oct 1, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds a Behavioral breaking changes entry to the 16.6 to 16.7 migration guide for the media type selection in Fix GraphQL over HTTP conformance gaps in the HTTP pipeline #10392 and Answer a single result as multipart or SSE only when the client names it #10455. The response format follows the Accept header's quality values, a q=0 media type is never chosen, and a single result is written as multipart/mixed or text/event-stream only when the header names that media type or its type/* range.
  • A table lists the headers whose response changes, for single results and for @defer and @stream results. The entry also states that a tie between the two envelopes goes to multipart/mixed, and when a 406 has no body.
  • Every row was measured against the 16.6.7 package and main, under the Legacy and default transport versions.

Copilot AI lite review requested due to automatic review settings October 1, 2026 07:35
@github-actions github-actions Bot added the 📚 documentation This issue is about working on our documentation. label Oct 1, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The migration guidance is complete and no unresolved issues were identified.

Review effort: Lite
Findings: None

What changed in this PR

Documents the 16.7 response format negotiation changes and migration impact.

Changes:

  • Explains Accept quality values and q=0 handling.
  • Documents single and streaming response behavior.
  • Clarifies envelope tie-breaking and bodyless 406 responses.
File Description
website/​content/​docs/​hotchocolate/​migrating/​migrate-from-16-6-to-16-7.md Adds response format migration guidance and behavior examples.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@glen-84
glen-84 merged commit d07fd72 into main Oct 1, 2026
23 checks passed
@glen-84
glen-84 deleted the gai/migration-guide-format-selection branch October 1, 2026 07:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📚 documentation This issue is about working on our documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants