Skip to content

Add .NET 11 breaking change article: MVC compatibility options removed - #37426

Open
Youssef1313 with Copilot wants to merge 2 commits into
mainfrom
copilot/remove-mvc-compatibility-options
Open

Add .NET 11 breaking change article: MVC compatibility options removed#37426
Youssef1313 with Copilot wants to merge 2 commits into
mainfrom
copilot/remove-mvc-compatibility-options

Conversation

Copilot AI commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

The CompatibilityVersion enum and related MVC compatibility APIs — obsolete since ASP.NET Core 6 and no-ops since 3.0 — were removed in dotnet/aspnetcore#67077. This documents the removal for .NET 11 Preview 7.

New article

  • aspnetcore/breaking-changes/11/mvc-compatibility-options-removed.md — covers version introduced, previous/new behavior, breaking change type (source + binary incompatible), reason, recommended action, and the affected APIs (SetCompatibilityVersion on both builder extension types, ConfigureCompatibilityOptions<TOptions>, MvcCompatibilityOptions, CompatibilityVersion).

Navigation

  • aspnetcore/toc.yml — TOC entry under .NET 11 breaking changes.
  • aspnetcore/breaking-changes/11/overview.md — table row, alphabetically placed, typed "Binary/source incompatible".

Related articles updated

  • aspnetcore/mvc/compatibility-version.md — notes the .NET 11 removal in the 3.0+ moniker section and links to the new article.
  • aspnetcore/mvc/overview.md — rewrites the "Compatibility version" section to past tense and links to the new article.

Recommended action documented is simply dropping the call:

// Before
services.AddMvc()
    .SetCompatibilityVersion(CompatibilityVersion.Latest);

// After
services.AddMvc();

Internal previews

File Preview link
aspnetcore/breaking-changes/11/mvc-compatibility-options-removed.md aspnetcore/breaking-changes/11/mvc-compatibility-options-removed
aspnetcore/breaking-changes/11/overview.md aspnetcore/breaking-changes/11/overview
aspnetcore/mvc/compatibility-version.md aspnetcore/mvc/compatibility-version
aspnetcore/mvc/overview.md aspnetcore/mvc/overview
aspnetcore/toc.yml aspnetcore/toc

Co-authored-by: Youssef1313 <31348972+Youssef1313@users.noreply.github.com>
Copilot AI changed the title [WIP] Remove obsolete Mvc compatibility options Add .NET 11 breaking change article: MVC compatibility options removed Aug 5, 2026
Copilot AI requested a review from Youssef1313 August 5, 2026 14:22
@Youssef1313
Youssef1313 marked this pull request as ready for review August 5, 2026 14:22
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.

[Breaking change]: Mvc compatibility options are removed

2 participants