[glen-84]

Summary

• Pins Cache-Control and Vary on HTTP QUERY responses. SharedMaxAgeAndVary_Should_Cache in HttpCachingTests and Query_With_SharedMaxAge_Should_Return_SMaxAge_Header in FusionCachingTests become theories with a POST row and a QUERY row, with EnableQueryRequests on. The QUERY row on the Hot Chocolate server matches the existing POST snapshot.
• Adds a QUERY Requests section to the Hot Chocolate and Fusion cache-control pages: how to enable QUERY, that RFC 10008 makes the response cacheable with the request body in the cache key, and that GET and persisted-operation GET routes are the portable choice because CDN support for caching QUERY responses varies.

Test plan

• HotChocolate.Caching.Tests and HotChocolate.Fusion.Caching.Tests pass on net10.0.
• With EnableQueryRequests off, both QUERY rows fail (the server answers 404, and the gateway writes no Cache-Control), so the rows go through the QUERY path.
• Prettier and cspell pass on both docs pages.

[Copilot]

🟢 Approval recommended

The reviewed changes have no unresolved blocking issues and all approval assessments indicate readiness.

No open issues 🎉

What changed in this PR

This pull request tests and documents cache headers for HTTP QUERY requests, confirming they match equivalent POST responses when QUERY support is enabled.

Changes:

• Extends Hot Chocolate and Fusion cache-control tests to cover POST and QUERY requests.
• Adds reusable HTTP request helpers supporting multiple methods.
• Documents QUERY configuration, cache-key behavior, response headers, and CDN compatibility.

File	Description
website/​content/​docs/​hotchocolate/​server/​cache-control.md	Documents enabling and caching HTTP QUERY requests for Hot Chocolate.
website/​content/​docs/​fusion/​cache-control.md	Documents enabling and caching HTTP QUERY requests through Fusion.
src/​HotChocolate/​Fusion/​test/​Fusion.Caching.Tests/​FusionCachingTests.cs	Verifies shared cache headers for POST and QUERY gateway requests.
src/​HotChocolate/​Caching/​test/​Caching.Tests/​HttpCachingTests.cs	Verifies matching cache-control and Vary headers for POST and QUERY server requests.

_{Review effort: Lite}