Skip to content

Remove duplicate C++ PackageReference experimental text #3573

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 5 commits into
base: main
Choose a base branch
from
Draft

Remove duplicate C++ PackageReference experimental text #3573

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
206efee
Document experimental C++ PackageReference support
Copilot May 19, 2026
e1493a1
Remove duplicated C++ experimental support note
Copilot May 19, 2026
b0e61f9
Remove redundant C++ experimental support sentence
Copilot May 19, 2026
9f7f701
Reorder C++ support notes in project type support section
Copilot May 19, 2026
45d1d13
Add spacing between support paragraphs
Copilot May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions docs/consume-packages/Package-References-in-Project-Files.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: NuGet PackageReference in project files
description: Details on NuGet PackageReference in project files as supported by NuGet 4.0+ and VS2017 and .NET Core 2.0
author: nkolev92
ms.author: nikolev
ms.date: 02/12/2026
ms.date: 05/19/2026
ms.update-cycle: 1095-days
ms.topic: concept-article
---
Expand All @@ -16,9 +16,15 @@ With PackageReference, you can also use MSBuild conditions to choose package ref

## Project type support

By default, PackageReference is used for .NET projects, .NET Standard projects, and UWP projects targeting Windows 10 Build 15063 (Creators Update) and later, with the exception of C++ UWP projects. .NET Framework projects support PackageReference, but currently default to `packages.config`. To use PackageReference in a .NET Framework project, [migrate](../consume-packages/migrate-packages-config-to-package-reference.md) the dependencies from `packages.config` into your project file, then remove packages.config.
By default, PackageReference is used for .NET projects, .NET Standard projects, and UWP projects targeting Windows 10 Build 15063 (Creators Update) and later.

ASP.NET apps that target the full .NET Framework include only [limited support](https://github.com/NuGet/Home/issues/5877) for PackageReference. C++ and JavaScript project types are unsupported.
.NET Framework projects support PackageReference, but currently default to `packages.config`.
To use PackageReference in a .NET Framework project, [migrate](../consume-packages/migrate-packages-config-to-package-reference.md) the dependencies from `packages.config` into your project file, then remove packages.config.

C++ PackageReference support is experimental.
For the latest C++ support details, see [NuGet PackageReference for C++ projects in Visual Studio](https://devblogs.microsoft.com/cppblog/nuget-packagereference-for-c-projects-in-visual-studio/).
ASP.NET apps that target the full .NET Framework include only [limited support](https://github.com/NuGet/Home/issues/5877) for PackageReference.
JavaScript project types are unsupported.

## Adding a PackageReference

Expand Down
7 changes: 5 additions & 2 deletions docs/consume-packages/install-use-packages-nuget-cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Manage NuGet Packages with the NuGet CLI
description: Find out how to use the NuGet CLI, nuget.exe, to manage NuGet packages in non-SDK-style projects that use a packages.config file to list package references.
author: mikejo5000
ms.author: mikejo
ms.date: 04/08/2026
ms.date: 05/19/2026
ms.topic: how-to
# customer intent: As a developer, I want to find out how to use the NuGet CLI so that I can manage NuGet packages in my projects and solutions.
---
Expand All @@ -15,7 +15,10 @@ You can use the `nuget.exe` command-line interface (CLI) to manage NuGet package
The NuGet CLI runs on .NET Framework and non-SDK-style projects, for example non-SDK-style projects that target .NET Standard libraries. The NuGet CLI commands can use a project [packages.config](../reference/packages-config.md) file that lists package references. For non-SDK-style projects that use `PackageReference` instead of *packages.config* for package references, use the [dotnet CLI](install-use-packages-dotnet-cli.md) instead.

> [!NOTE]
> For most non-SDK-style projects that use *packages.config*, it's best to [migrate packages.config to `PackageReference`](migrate-packages-config-to-package-reference.md), and then use the dotnet CLI instead of the NuGet CLI to manage packages. However, you can't migrate C++ or ASP.NET projects.
> For most non-SDK-style projects that use *packages.config*, it's best to [migrate packages.config to `PackageReference`](migrate-packages-config-to-package-reference.md), and then use the dotnet CLI instead of the NuGet CLI to manage packages.
> However, you can't use the migration tool for C++ or ASP.NET projects.
> C++ PackageReference support is experimental.
> For the latest C++ support details, see [NuGet PackageReference for C++ projects in Visual Studio](https://devblogs.microsoft.com/cppblog/nuget-packagereference-for-c-projects-in-visual-studio/).

For most commands, the NuGet CLI tool uses the current folder, unless you specify a different location in the command. To run NuGet CLI commands, open a command-line program and switch to the folder that contains your project file.

Expand Down
7 changes: 5 additions & 2 deletions docs/consume-packages/migrate-packages-config-to-package-reference.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Migrating from packages.config to PackageReference formats
description: Details on how to migrate a project from the packages.config management format to PackageReference as supported by NuGet 4.0+ and VS2017 and .NET Core 2.0
author: JonDouglas
ms.author: jodou
ms.date: 08/23/2021
ms.date: 05/19/2026
ms.topic: upgrade-and-migration-article
---

Expand Down Expand Up @@ -43,7 +43,10 @@ Perform any one of the following NuGet actions:
* Run NuGet restore - Right-click on the solution node in the Solution Explorer and select `Restore NuGet Packages`
* Build the project which also triggers NuGet restore

You should now be able to see the migration option. Note that this option is not supported and will not show up for ASP.NET and C++ project types.
You should now be able to see the migration option.
Note that this option is not supported and won't show up for ASP.NET and C++ project types.
C++ PackageReference support is experimental.
For the latest C++ support details, see [NuGet PackageReference for C++ projects in Visual Studio](https://devblogs.microsoft.com/cppblog/nuget-packagereference-for-c-projects-in-visual-studio/).

## Migration steps

Expand Down