Skip to content

Conversation

@meaghanlewis
Copy link
Contributor

@meaghanlewis meaghanlewis commented Oct 28, 2025

Summary

This pull request updates multiple .NET CLI documentation files to reflect .NET 6 as the minimum supported SDK version, removes references to older SDKs and options, and cleans up some outdated or redundant information. The changes help ensure that the docs are more accurate and relevant for current users.

SDK version and applicability updates:

  • Updated all relevant documentation files to indicate that they apply to ".NET 6 SDK and later versions" instead of older SDKs such as .NET Core 3.1 or .NET 5.0.

Removal of deprecated or outdated information:

  • Removed references to options and behaviors only available in older SDKs.
  • Removed the section on DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX environment variable, which has been superseded.
  • Cleaned up outdated notes about bugs and workarounds relevant only to older SDK versions.

Content modernization and clarity:

  • Updated introductory and descriptive text to remove references to deprecated behaviors and make instructions clearer for .NET 6+ users.

These updates collectively improve the accuracy and maintainability of the .NET CLI documentation for current and future users.

Fixes #49497


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/core/tools/dotnet-build-server.md dotnet build-server
docs/core/tools/dotnet-environment-variables.md .NET environment variables
docs/core/tools/dotnet-help.md dotnet help command
docs/core/tools/dotnet-new-list.md dotnet new list
docs/core/tools/dotnet-new-sdk-templates.md Default templates for dotnet new
docs/core/tools/dotnet-new-search.md docs/core/tools/dotnet-new-search
docs/core/tools/dotnet-new-update.md dotnet new update
docs/core/tools/dotnet-new.md dotnet new <TEMPLATE>
docs/core/tools/dotnet-nuget-add-source.md dotnet nuget add source command
docs/core/tools/dotnet-nuget-delete.md dotnet nuget delete
docs/core/tools/dotnet-nuget-disable-source.md docs/core/tools/dotnet-nuget-disable-source
docs/core/tools/dotnet-nuget-enable-source.md dotnet nuget enable source
docs/core/tools/dotnet-nuget-list-source.md dotnet nuget list source command
docs/core/tools/dotnet-nuget-locals.md dotnet nuget locals
docs/core/tools/dotnet-nuget-push.md docs/core/tools/dotnet-nuget-push
docs/core/tools/dotnet-nuget-remove-source.md dotnet nuget remove source
docs/core/tools/dotnet-nuget-trust.md dotnet nuget trust command
docs/core/tools/dotnet-nuget-update-source.md dotnet nuget update source
docs/core/tools/dotnet-nuget-verify.md docs/core/tools/dotnet-nuget-verify
docs/core/tools/dotnet-package-add.md dotnet package add
docs/core/tools/dotnet-package-list.md dotnet package list command
docs/core/tools/dotnet-reference-add.md dotnet reference add
docs/core/tools/dotnet-reference-list.md docs/core/tools/dotnet-reference-list
docs/core/tools/dotnet-reference-remove.md dotnet reference remove
docs/core/tools/dotnet-sln.md dotnet sln command
docs/core/tools/dotnet-tool-install.md dotnet tool install
docs/core/tools/dotnet-tool-list.md docs/core/tools/dotnet-tool-list
docs/core/tools/dotnet-tool-restore.md dotnet tool restore
docs/core/tools/dotnet-tool-run.md dotnet tool run command
docs/core/tools/dotnet-vstest.md dotnet vstest

Note

This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.

@dotnetrepoman dotnetrepoman bot added this to the October 2025 milestone Oct 28, 2025
@meaghanlewis meaghanlewis marked this pull request as ready for review October 28, 2025 21:35
@meaghanlewis meaghanlewis requested a review from a team as a code owner October 28, 2025 21:35
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 the .NET CLI documentation to reflect current version requirements and remove outdated information. The changes standardize the minimum supported SDK version across all command documentation files and clean up version-specific notes that are no longer relevant.

  • Updates "This article applies to" sections from .NET Core 3.1/5.0 to .NET 6 SDK as the minimum supported version
  • Removes outdated version-specific notes and availability statements (e.g., "Available since .NET Core X SDK")
  • Updates the last modified date (ms.date) to 10/28/2025 across all modified files

Reviewed Changes

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

Show a summary per file
File Description
docs/core/tools/dotnet.md Updated SDK version requirement and ms.date
docs/core/tools/dotnet-vstest.md Updated SDK version, ms.date, removed syntax error, and corrected Framework example
docs/core/tools/dotnet-tool-*.md Updated SDK version requirements and ms.date for all tool commands
docs/core/tools/dotnet-sln.md Updated SDK version requirement and ms.date
docs/core/tools/dotnet-reference-*.md Updated SDK version requirements and ms.date for reference commands
docs/core/tools/dotnet-package-*.md Updated SDK version, ms.date, and removed version-specific availability note
docs/core/tools/dotnet-nuget-*.md Updated SDK version requirements and ms.date for all nuget commands
docs/core/tools/dotnet-nuget-push.md Additionally removed outdated notes about .NET Core 2.1 SDK bugs
docs/core/tools/dotnet-new*.md Updated SDK version, ms.date, removed outdated search behavior notes, and cleaned up version-specific availability statements
docs/core/tools/dotnet-help.md Updated SDK version requirement and ms.date
docs/core/tools/dotnet-environment-variables.md Updated SDK version, ms.date, and removed deprecated DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX section
docs/core/tools/dotnet-build-server.md Updated SDK version requirement and ms.date

meaghanlewis and others added 2 commits October 28, 2025 14:44
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This LGTM @meaghanlewis

Let's :shipit:

@meaghanlewis meaghanlewis merged commit 145e0c1 into dotnet:main Oct 29, 2025
8 checks passed
@meaghanlewis meaghanlewis deleted the update-cli-applies-to-version branch October 29, 2025 18:56
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.

Update applies to version for .NET CLI docs

2 participants