Skip to content

Move Native AOT optimized publish breaking change to .NET 12 - #56885

Open
marcpopMSFT wants to merge 1 commit into
mainfrom
marcpopMSFT-moveoptimizedpublishingto12
Open

marcpopMSFT wants to merge 1 commit into
mainfrom
marcpopMSFT-moveoptimizedpublishingto12

Conversation

@marcpopMSFT

@marcpopMSFT marcpopMSFT commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

Summary

Native AOT optimized publish was disabled for .NET 11 GA and will be enabled by default again in .NET 12 Preview 1. This PR moves the breaking-change article added in #56473 from the .NET 11 location to a new .NET 12 location and documents the version history:

  • Enabled by default in .NET SDK 11.0.100-rc.2.
  • Made opt-in (UseOptimizedPublish=true) in .NET SDK 11.0.100.
  • Enabled by default again in .NET 12 Preview 1.

Changes:

  • Moved docs/core/compatibility/sdk/11/aot-publish-skips-full-build.md to sdk/12/ and updated the version information.
  • Added docs/core/compatibility/12.md (new .NET 12 breaking changes overview) and a .NET 12 section in the compatibility TOC.
  • Removed the entry from the .NET 11 overview and TOC.
  • Added a redirect from the old article URL.
  • Updated the link in the .NET 11 What's new SDK article.

Validation: npx --yes markdownlint-cli2 on the edited Markdown files passed (0 issues); the redirection JSON parses successfully.


Internal previews

File Preview link
.openpublishing.redirection.core.json Learn preview
docs/core/compatibility/11.md Learn preview
docs/core/compatibility/12.md Learn preview
docs/core/compatibility/sdk/12/aot-publish-skips-full-build.md Learn preview
docs/core/compatibility/toc.yml Learn preview
docs/core/whats-new/dotnet-11/sdk.md Learn preview

Build report

Optimized publish was enabled in 11.0.100-rc.2, made opt-in for 11.0.100, and is enabled by default again in .NET 12 Preview 1.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 99acc4bc-4dfd-4a02-8122-4ab3c2d61beb
Copilot AI balanced review requested due to automatic review settings November 12, 2026 18:01
@dotnetrepoman dotnetrepoman Bot added this to the November 2026 milestone Nov 12, 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.

🟢 Approval recommended

No active review issues remain for the documentation move to .NET 12.

No open issues 🎉

What changed in this PR

Moves the Native AOT optimized-publish breaking-change documentation to .NET 12, reflecting that the feature remains opt-in in .NET 11 GA and becomes enabled by default again in .NET 12 Preview 1.

Changes:

  • Documents the version history and updates the article’s release information.
  • Adds the .NET 12 overview and navigation entry, and removes the .NET 11 entries.
  • Preserves the old article URL with a redirect and updates the .NET 11 SDK article link.
File Description
docs/​core/​whats-new/​dotnet-11/​sdk.md Updates the link and notes the .NET 12 default.
docs/​core/​compatibility/​toc.yml Moves navigation to a new .NET 12 section.
docs/​core/​compatibility/​sdk/​12/​aot-publish-skips-full-build.md Updates the release scope and documents version history.
docs/​core/​compatibility/​12.md Adds the .NET 12 breaking-changes overview.
docs/​core/​compatibility/​11.md Removes the optimized-publish breaking-change entry.
.openpublishing.redirection.core.json Redirects the old article URL to its .NET 12 location.

Review effort: Balanced

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.

2 participants