Skip to content

Add some notes to warn against this feature#51517

Merged
adegeo merged 2 commits intomainfrom
adegeo/48203/store
Feb 5, 2026
Merged

Add some notes to warn against this feature#51517
adegeo merged 2 commits intomainfrom
adegeo/48203/store

Conversation

@adegeo
Copy link
Contributor

@adegeo adegeo commented Feb 4, 2026

Summary

  • Added notes to the doc and the command doc that let users know they really shouldn't use this because it's deprecated.

Fixes #48203


Internal previews

📄 File 🔗 Preview link
docs/core/deploying/runtime-store.md Runtime package store
docs/core/tools/dotnet-store.md dotnet store command

@adegeo adegeo requested review from a team and meaghanlewis as code owners February 4, 2026 20:54
Copilot AI review requested due to automatic review settings February 4, 2026 20:54
@dotnetrepoman dotnetrepoman bot added this to the February 2026 milestone Feb 4, 2026
Copy link
Contributor

Copilot AI left a comment

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 documentation for the dotnet store command and the runtime package store to clearly indicate that the feature is deprecated, not supported on modern .NET, and generally should not be used. It adds prominent warnings, cautions, and a workaround note to reduce confusion for users encountering this legacy feature.

Changes:

  • Updated dotnet store command docs with front matter metadata, an AI usage flag, and high-visibility warnings about deprecation and known issues on .NET 6 and later.
  • Updated the runtime package store article with warnings, cautions, and clearly marked legacy sections, including a discouraged workaround, to emphasize that the feature is deprecated and not supported on modern .NET.
  • Added a reference link to the relevant GitHub issue documenting the dotnet store/crossgen problems.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/core/tools/dotnet-store.md Marks the command as deprecated/unsupported, updates metadata, and adds cautions about failures and unreliable behavior on .NET 6+.
docs/core/deploying/runtime-store.md Clearly flags the runtime package store as deprecated/unsupported, updates historical description language, adds cautions around usage and publishing, marks ASP.NET Core 2.0 behavior as legacy, and links to the tracking GitHub issue.

Copy link
Contributor

Copilot AI commented Feb 5, 2026

@adegeo I've opened a new pull request, #51530, to work on those changes. Once the pull request is ready, I'll request review from you.

* Initial plan

* Fix heading dash formatting to comply with style guide

Co-authored-by: adegeo <67293991+adegeo@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: adegeo <67293991+adegeo@users.noreply.github.com>
@adegeo adegeo merged commit d1b8404 into main Feb 5, 2026
11 checks passed
@adegeo adegeo deleted the adegeo/48203/store branch February 5, 2026 19:20
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.

Runtime store is not supported anymore, please remove documentation

3 participants