Skip to content

docs: Document .NET 8 self-contained deployment default change and add troubleshooting#53498

Closed
gewarren with Copilot wants to merge 4 commits into
mainfrom
copilot/fix-doc-gap-net8-self-contained-change
Closed

docs: Document .NET 8 self-contained deployment default change and add troubleshooting#53498
gewarren with Copilot wants to merge 4 commits into
mainfrom
copilot/fix-doc-gap-net8-self-contained-change

Conversation

Copilot AI commented Apr 29, 2026

Copy link
Copy Markdown
Contributor

In .NET 8, specifying -r <RID> no longer implies --self-contained — apps now publish framework-dependent by default even with a RID. This silent behavioral change from .NET 7 has caused widespread confusion (16k-view SO question).

Changes to docs/core/deploying/index.md

  • Breaking change callout — Added [!IMPORTANT] alert at the top of the Self-contained deployment section, explicitly stating that -r <RID> alone no longer produces a self-contained app in .NET 8+:

    # .NET 7 behavior (implicit self-contained)
    dotnet publish -r win-x64
    
    # .NET 8+ required form
    dotnet publish -r win-x64 --self-contained
  • Troubleshooting section — Added ## Troubleshoot self-contained deployment before ## See also with:

    • App prompts for .NET runtime installation — root cause explanation + fix for both CLI and Visual Studio
    • Verify that publish output is self-contained — tells readers to check for coreclr.dll / libcoreclr.so / libcoreclr.dylib in the publish folder; includes project-file fix via <SelfContained>true</SelfContained>
  • See also — Added link to the Runtime-specific apps no longer self-contained breaking change article


Internal previews

📄 File 🔗 Preview link
docs/core/deploying/index.md .NET application publishing overview

Copilot AI changed the title [WIP] Add documentation for .NET 8 self-contained deployment change docs: Document .NET 8 self-contained deployment default change and add troubleshooting Apr 29, 2026
Copilot AI requested a review from gewarren April 29, 2026 21:48
Comment thread docs/core/deploying/index.md Outdated
Removed troubleshooting section for self-contained deployment, including common issues and verification steps.
Copilot AI review requested due to automatic review settings June 10, 2026 19:22
@gewarren
gewarren marked this pull request as ready for review June 10, 2026 19:22
@gewarren
gewarren requested review from a team and adegeo as code owners June 10, 2026 19:22

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.

Pull request overview

This PR updates the .NET deployment documentation to highlight the .NET 8 behavioral change where specifying a RID (-r <RID>) no longer implies a self-contained publish, and it adds an additional cross-link to the related breaking change article.

Changes:

  • Added an [!IMPORTANT] callout in the Self-contained deployment section describing the .NET 8 breaking change and linking to the breaking change article.
  • Added a See also link to the “Runtime-specific apps no longer self-contained” breaking change article.

Comment thread docs/core/deploying/index.md Outdated
Comment thread docs/core/deploying/index.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@gewarren gewarren closed this Jun 10, 2026
@gewarren gewarren reopened this Jun 10, 2026
@gewarren
gewarren enabled auto-merge (squash) June 10, 2026 20:37
@gewarren gewarren closed this Jun 15, 2026
auto-merge was automatically disabled June 15, 2026 22:57

Pull request was closed

@gewarren gewarren reopened this Jun 15, 2026
@gewarren

Copy link
Copy Markdown
Collaborator

Closing per @adegeo. This update isn't necessary.

@gewarren gewarren closed this Jun 16, 2026
@gewarren
gewarren deleted the copilot/fix-doc-gap-net8-self-contained-change branch June 16, 2026 17:37
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.

Doc gap: .NET 8 self-contained deployment default change not prominently documented

4 participants