docs: Breaking change — Some Microsoft.Extensions packages in .NET 11 shared framework#53565
Open
docs: Breaking change — Some Microsoft.Extensions packages in .NET 11 shared framework#53565
Conversation
3 tasks
dotnet-policy-service
Bot
added
the
okr-quality
…d framework (.NET 11) Agent-Logs-Url: https://github.com/dotnet/docs/sessions/e8635257-475f-450d-8351-50107ec8c6e1 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
…rticle Agent-Logs-Url: https://github.com/dotnet/docs/sessions/e8635257-475f-450d-8351-50107ec8c6e1 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Fix issue with Microsoft.Extensions libraries in .NET 11+
docs: Breaking change — Microsoft.Extensions.* Abstractions/Options/Primitives in .NET 11 shared framework
May 5, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new .NET 11 compatibility article documenting that several Microsoft.Extensions.* assemblies are now provided by the shared framework (triggering NU1510 when referenced explicitly), and wires the new article into the .NET 11 compatibility index and TOC.
Changes:
- Added a new breaking change article describing the shared-framework inclusion of nine
Microsoft.Extensions.*libraries and related guidance. - Linked the new article from the .NET 11 Extensions compatibility index page.
- Added the new article to the compatibility TOC under .NET 11 > Extensions.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| docs/core/compatibility/extensions/11/extensions-in-shared-framework.md | New breaking change article describing NU1510 implications and recommended actions for framework-provided Microsoft.Extensions.* assemblies. |
| docs/core/compatibility/11.md | Adds the new Extensions breaking change to the .NET 11 index table. |
| docs/core/compatibility/toc.yml | Adds a TOC entry for the new .NET 11 Extensions breaking change article. |
gewarren
approved these changes
May 5, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Contributor
|
@copilot Please respond to remaining feedback. |
…geting guidance Agent-Logs-Url: https://github.com/dotnet/docs/sessions/b2a02110-0ef1-4f11-be45-fec2c67a75d5 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Contributor
Author
Addressed in commit 2074387:
|
Copilot
AI
changed the title
docs: Breaking change — Microsoft.Extensions.* Abstractions/Options/Primitives in .NET 11 shared framework
docs: Breaking change — Some Microsoft.Extensions packages in .NET 11 shared framework
May 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Nine
Microsoft.Extensions.*libraries are now part of the .NET 11 base shared framework, making explicitPackageReferenceentries unnecessary fornet11.0-only projects and triggering NU1510 warnings. Projects pinned to old package versions may encounter runtime failures (MissingMethodException,TypeLoadException) due to accumulated breaking changes between those versions and 11.0.Changes
docs/core/compatibility/extensions/11/extensions-in-shared-framework.mdPackageReferencefornet11.0-only projectsnet10.0;net11.0); includes a conditionalPackageReferenceexample for projects that want to be explicitdocs/core/compatibility/11.md— added entry to Extensions tabledocs/core/compatibility/toc.yml— added entry under Extensions/.NET 11Internal previews