Skip to content

Add HTTP3 breaking change documentation for .NET 10 Preview 6 #47526

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jul 24, 2025

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Jul 22, 2025

This PR adds comprehensive documentation for the breaking change introduced in .NET 10 Preview 6 where HTTP3 support in System.Net.Http is disabled by default when PublishTrimmed or PublishAot is set to true.

Changes Made

  • Created new breaking change document: docs/core/compatibility/networking/10.0/http3-disabled-with-publishtrimmed.md

    • Follows the established format from .github/prompts/breaking-change.md
    • Includes proper YAML front matter with metadata
    • Documents the behavior change, reasoning, and recommended actions
    • Provides clear XML configuration examples for re-enabling HTTP3 support
  • Updated compatibility index: docs/core/compatibility/10.0.md

    • Added entry to the Networking section table
    • Classified as "Source incompatible" breaking change
    • Listed as introduced in Preview 6
  • Updated table of contents: docs/core/compatibility/toc.yml

    • Added navigation entry under Networking → .NET 10 section
    • Maintains proper YAML structure and indentation

Documentation Content

The new documentation explains:

  • Previous behavior: HTTP3 support was allowed but might not work in environments without msquic
  • New behavior: HTTP3 is disabled and code is not included in trimmed/AOT applications
  • Reason: Reduces application size and complexity since HTTP3 often requires extra configuration
  • Recommended action: Set <Http3Support>true</Http3Support> property when HTTP3 is needed

Example configuration provided:

<PropertyGroup>
  <PublishTrimmed>true</PublishTrimmed>
  <Http3Support>true</Http3Support>
</PropertyGroup>

The documentation follows Microsoft's writing style guidelines and is consistent with other .NET 10 breaking change documents in the repository.

Fixes #47443.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.


Internal previews

📄 File 🔗 Preview link
docs/core/compatibility/10.0.md Breaking changes in .NET 10
docs/core/compatibility/networking/10.0/http3-disabled-with-publishtrimmed.md HTTP/3 support in System.Net.Http disabled by default with PublishTrimmed
docs/core/compatibility/toc.yml docs/core/compatibility/toc
docs/core/deploying/trimming/trimming-options.md Trimming options

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] [Breaking change]: HTTP3 support in System.Net.Http disabled by default with PublishTrimmed Add HTTP3 breaking change documentation for .NET 10 Preview 6 Jul 22, 2025
@Copilot Copilot AI requested a review from gewarren July 22, 2025 21:07
Copilot finished work on behalf of gewarren July 22, 2025 21:07
@gewarren gewarren marked this pull request as ready for review July 22, 2025 22:11
@gewarren gewarren requested review from adegeo and a team as code owners July 22, 2025 22:11
@gewarren gewarren merged commit 383efc6 into main Jul 24, 2025
10 checks passed
@gewarren gewarren deleted the copilot/fix-47443 branch July 24, 2025 15:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Breaking change]: HTTP3 support in System.Net.Http disabled by default with PublishTrimmed
3 participants