From 69dbaffbb2c1d5162f58ea9aed95b555804aa6b1 Mon Sep 17 00:00:00 2001
From: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com>
Date: Mon, 6 Oct 2025 07:26:24 -0700
Subject: [PATCH 1/4] Update package index with latest published versions
(#48906)
---
docs/azure/includes/dotnet-all.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md
index 5f6f767810260..5194ddd335170 100644
--- a/docs/azure/includes/dotnet-all.md
+++ b/docs/azure/includes/dotnet-all.md
@@ -426,7 +426,7 @@
| Unknown Display Name | NuGet [0.8.4](https://www.nuget.org/packages/Azure.Mcp.osx-x64/0.8.4) | | |
| Unknown Display Name | NuGet [0.8.4](https://www.nuget.org/packages/Azure.Mcp.win-arm64/0.8.4) | | |
| Unknown Display Name | NuGet [0.8.4](https://www.nuget.org/packages/Azure.Mcp.win-x64/0.8.4) | | |
-| Unknown Display Name | NuGet [0.1.3-preview.2](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Aot/0.1.3-preview.2) | | |
+| Unknown Display Name | NuGet [0.1.4-preview.2](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Aot/0.1.4-preview.2) | | |
| Unknown Display Name | NuGet [0.2.802](https://www.nuget.org/packages/Microsoft.Azure.Mcp.AzTypes.Internal.Compact/0.2.802) | | |
| Unknown Display Name | NuGet [1.1.2-preview](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.AzureCosmosDb.Mongo/1.1.2-preview) | | |
| Unknown Display Name | NuGet [1.46.0](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech.Extension.MAS/1.46.0) | | |
@@ -465,7 +465,7 @@
| Common | NuGet [2.2.1](https://www.nuget.org/packages/Microsoft.Azure.Common/2.2.1) | | |
| Common - Dependencies | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.Common.Dependencies/1.0.0) | | |
| Computer Vision | NuGet [7.0.1](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Vision.ComputerVision/7.0.1) | | GitHub [7.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.CognitiveServices.Vision.ComputerVision_6.0.0-preview.1/sdk/cognitiveservices/Vision.ComputerVision) |
-| Cosmos DB | NuGet [3.47.0](https://www.nuget.org/packages/Microsoft.Azure.Cosmos/3.47.0)
NuGet [3.54.0-preview.1](https://www.nuget.org/packages/Microsoft.Azure.Cosmos/3.54.0-preview.1) | [docs](/dotnet/api/overview/azure/cosmosdb) | GitHub [3.47.0](https://github.com/Azure/azure-cosmos-dotnet-v3/tree/3.12.0/Microsoft.Azure.Cosmos) |
+| Cosmos DB | NuGet [3.47.0](https://www.nuget.org/packages/Microsoft.Azure.Cosmos/3.47.0)
NuGet [3.55.0-preview.0](https://www.nuget.org/packages/Microsoft.Azure.Cosmos/3.55.0-preview.0) | [docs](/dotnet/api/overview/azure/cosmosdb) | GitHub [3.47.0](https://github.com/Azure/azure-cosmos-dotnet-v3/tree/3.12.0/Microsoft.Azure.Cosmos) |
| Custom Vision Prediction | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Vision.CustomVision.Prediction/2.0.0) | | GitHub [2.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.CognitiveServices.Vision.CustomVision.Prediction_2.0.0/sdk/cognitiveservices/Vision.CustomVision.Prediction) |
| Custom Vision Training | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Vision.CustomVision.Training/2.0.0)
NuGet [2.1.0-preview](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Vision.CustomVision.Training/2.1.0-preview) | | GitHub [2.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.CognitiveServices.Vision.CustomVision.Training_2.0.0/sdk/cognitiveservices/Vision.CustomVision.Training) |
| Data Lake Analytics | NuGet [1.4.211011](https://www.nuget.org/packages/Microsoft.Azure.DataLake.USQL.SDK/1.4.211011) | | |
From 8fda919fd5a63c304a95d44d0ebc9dfb4d6799fe Mon Sep 17 00:00:00 2001
From: Olabamiji Oyetubo <60369677+bigboybamo@users.noreply.github.com>
Date: Mon, 6 Oct 2025 15:27:09 +0100
Subject: [PATCH 2/4] Update cs0132 static constructors (#48907)
* Update access-modifiers.md
Added description for file access type modifier
* Update cs0132.md
---
docs/csharp/misc/cs0132.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/csharp/misc/cs0132.md b/docs/csharp/misc/cs0132.md
index 7590d2b5097f3..1aed19ee48f1b 100644
--- a/docs/csharp/misc/cs0132.md
+++ b/docs/csharp/misc/cs0132.md
@@ -12,7 +12,7 @@ ms.assetid: e8ad1281-2912-4b6a-b2af-a319a23ddd16
'constructor' : a static constructor must be parameterless
- A [static](../language-reference/keywords/static.md) constructor cannot be declared with one or more parameters. For more information, see [Constructors](../programming-guide/classes-and-structs/constructors.md).
+ A [static](../language-reference/keywords/static.md) constructor cannot be declared with one or more parameters. For more information, see [Static Constructors](../programming-guide/classes-and-structs/static-constructors.md).
The following sample generates CS0132:
From f3e5619f4097c1611eb682eef670cc73eb2df3e2 Mon Sep 17 00:00:00 2001
From: "Meaghan Osagie (Lewis)"
Date: Mon, 6 Oct 2025 10:41:33 -0700
Subject: [PATCH 3/4] [DocsArchive-1.0.25268.1](2025-10-01-01-10-04)Auto
archive content (#48805)
* [DocsArchive-1.0.25268.1](2025-10-01-01-10-04)Auto archive content
* update TOC
* remove links to dotnet-migrate
* fix links to dotnet migrate command in documentation
* Update redirect URL for dotnet-migrate documentation
* Update redirect URL for dotnet-migrate documentation
* Update docs/core/compatibility/sdk/10.0/dotnet-restore-project-json-unsupported.md
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
* Update docs/core/compatibility/sdk/10.0/dotnet-restore-project-json-unsupported.md
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---------
Co-authored-by: Docs.Archive pipeline
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
.openpublishing.redirection.json | 5 +
...dotnet-restore-project-json-unsupported.md | 4 +-
docs/core/tools/dotnet-migrate.md | 103 ------------------
docs/core/tools/dotnet.md | 1 -
docs/core/tools/index.md | 1 -
docs/navigate/tools-diagnostics/toc.yml | 2 -
6 files changed, 7 insertions(+), 109 deletions(-)
delete mode 100644 docs/core/tools/dotnet-migrate.md
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
index 774861bd193a8..2a1fac42e3233 100644
--- a/.openpublishing.redirection.json
+++ b/.openpublishing.redirection.json
@@ -1,5 +1,10 @@
{
"redirections": [
+ {
+ "source_path": "docs/core/tools/dotnet-migrate.md",
+ "redirect_url": "/previous-versions/dotnet/fundamentals/tools/dotnet-migrate",
+ "redirect_document_id": false
+ },
{
"source_path": "docs/core/install/localized-intellisense.md",
"redirect_url": "/previous-versions/dotnet/core/install/localized-intellisense",
diff --git a/docs/core/compatibility/sdk/10.0/dotnet-restore-project-json-unsupported.md b/docs/core/compatibility/sdk/10.0/dotnet-restore-project-json-unsupported.md
index 4feb15a2d811b..a182b557dae3e 100644
--- a/docs/core/compatibility/sdk/10.0/dotnet-restore-project-json-unsupported.md
+++ b/docs/core/compatibility/sdk/10.0/dotnet-restore-project-json-unsupported.md
@@ -30,7 +30,7 @@ This change can affect [source compatibility](../../categories.md#source-compati
The `project.json` format was originally available only in .NET Core previews (through Preview 2 of .NET Core 1.0) and was completely replaced by PackageReference in 2017. The format has been marked as deprecated since 2017.
-When the `project.json` format was replaced, users migrated these projects using the [`dotnet migrate`](../../../tools/dotnet-migrate.md) command, but that command was removed from the CLI in the .NET Core 3.0 SDK.
+When the `project.json` format was replaced, users migrated these projects using the [`dotnet migrate`](/previous-versions/dotnet/fundamentals/tools/dotnet-migrate) command, but that command was removed from the CLI in the .NET Core 3.0 SDK.
The removal of `project.json` support completes this transition and allows the .NET team to focus on delivering a better experience for PackageReference-based projects.
@@ -38,7 +38,7 @@ The removal of `project.json` support completes this transition and allows the .
Migrate your `project.json` projects to use PackageReference format instead.
-If you have .NET Core based `project.json` projects, you can use older versions of the .NET SDK that still include the [`dotnet migrate` command](../../../tools/dotnet-migrate.md) to convert them to the modern project format.
+If you have .NET Core based `project.json` projects, you can use older versions of the .NET SDK that still include the [`dotnet migrate` command](/previous-versions/dotnet/fundamentals/tools/dotnet-migrate) to convert them to the modern project format.
For more information about migrating from `project.json`, see [Migrating from project.json to .csproj](/nuget/archive/project-json#migrate-projectjson-to-packagereference).
diff --git a/docs/core/tools/dotnet-migrate.md b/docs/core/tools/dotnet-migrate.md
deleted file mode 100644
index 718f3d6284c87..0000000000000
--- a/docs/core/tools/dotnet-migrate.md
+++ /dev/null
@@ -1,103 +0,0 @@
----
-title: dotnet migrate command
-description: The dotnet migrate command migrates a project and all of its dependencies.
-ms.date: 02/14/2020
----
-# dotnet migrate
-
-**This article applies to:** ✔️ .NET Core 2.x SDK
-
-## Name
-
-`dotnet migrate` - Migrates a Preview 2 .NET Core project to a .NET Core SDK-style project.
-
-## Synopsis
-
-```dotnetcli
-dotnet migrate [] [--format-report-file-json ]
- [-r|--report-file ] [-s|--skip-project-references [Debug|Release]]
- [--skip-backup] [-t|--template-file ] [-v|--sdk-package-version]
- [-x|--xproj-file]
-
-dotnet migrate -h|--help
-```
-
-## Description
-
-This command is deprecated. The `dotnet migrate` command is no longer available starting with .NET Core 3.0 SDK. It can only migrate a Preview 2 .NET Core project to a 1.x .NET Core project, which is out of support.
-
-By default, the command migrates the root project and any project references that the root project contains. This behavior is disabled using the `--skip-project-references` option at run time.
-
-Migration can be performed on the following assets:
-
-* A single project by specifying the *project.json* file to migrate.
-* All of the directories specified in the *global.json* file by passing in a path to the *global.json* file.
-* A *solution.sln* file, where it migrates the projects referenced in the solution.
-* On all subdirectories of the given directory recursively.
-
-The `dotnet migrate` command keeps the migrated *project.json* file inside a `backup` directory, which it creates if the directory doesn't exist. This behavior is overridden using the `--skip-backup` option.
-
-By default, the migration operation outputs the state of the migration process to standard output (STDOUT). If you use the `--report-file ` option, the output is saved to the file specify.
-
-The `dotnet migrate` command only supports valid Preview 2 *project.json*-based projects. This means that you cannot use it to migrate DNX or Preview 1 *project.json*-based projects directly to MSBuild/csproj projects. You first need to manually migrate the project to a Preview 2 *project.json*-based project and then use the `dotnet migrate` command to migrate the project.
-
-## Arguments
-
-`PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR`
-
-The path to one of the following:
-
-* a *project.json* file to migrate.
-* a *global.json* file: the folders specified in *global.json* are migrated.
-* a *solution.sln* file: the projects referenced in the solution are migrated.
-* a directory to migrate: recursively searches for *project.json* files to migrate inside the specified directory.
-
-Defaults to current directory if nothing is specified.
-
-## Options
-
-`--format-report-file-json `
-
-Output migration report file as JSON rather than user messages.
-
-`-h|--help`
-
-Prints out a short help for the command.
-
-`-r|--report-file `
-
-Output migration report to a file in addition to the console.
-
-`-s|--skip-project-references [Debug|Release]`
-
-Skip migrating project references. By default, project references are migrated recursively.
-
-`--skip-backup`
-
-Skip moving *project.json*, *global.json*, and *\*.xproj* to a `backup` directory after successful migration.
-
-`-t|--template-file `
-
-Template csproj file to use for migration. By default, the same template as the one dropped by `dotnet new console` is used.
-
-`-v|--sdk-package-version `
-
-The version of the sdk package that's referenced in the migrated app. The default is the version of the SDK in `dotnet new`.
-
-`-x|--xproj-file `
-
-The path to the xproj file to use. Required when there is more than one xproj in a project directory.
-
-## Examples
-
-Migrate a project in the current directory and all of its project-to-project dependencies:
-
-`dotnet migrate`
-
-Migrate all projects that *global.json* file includes:
-
-`dotnet migrate path/to/global.json`
-
-Migrate only the current project and no project-to-project (P2P) dependencies. Also, use a specific SDK version:
-
-`dotnet migrate -s -v 1.0.0-preview4`
diff --git a/docs/core/tools/dotnet.md b/docs/core/tools/dotnet.md
index b77d496cf5150..d95a2e3703420 100644
--- a/docs/core/tools/dotnet.md
+++ b/docs/core/tools/dotnet.md
@@ -170,7 +170,6 @@ The following options are available only when `dotnet` runs an application by us
| [dotnet clean](dotnet-clean.md) | Clean build outputs. |
| [dotnet exec](#options-for-running-an-application) | Runs a .NET application. |
| [dotnet help](dotnet-help.md) | Shows more detailed documentation online for the command. |
-| [dotnet migrate](dotnet-migrate.md) | Migrates a valid Preview 2 project to a .NET Core SDK 1.0 project. |
| [dotnet msbuild](dotnet-msbuild.md) | Provides access to the MSBuild command line. |
| [dotnet new](dotnet-new.md) | Initializes a C# or F# project for a given template. |
| [dotnet pack](dotnet-pack.md) | Creates a NuGet package of your code. |
diff --git a/docs/core/tools/index.md b/docs/core/tools/index.md
index fd4d4a5a6165d..5998715ea5d5e 100644
--- a/docs/core/tools/index.md
+++ b/docs/core/tools/index.md
@@ -64,7 +64,6 @@ The following commands are installed by default:
- [`test`](dotnet-test.md)
- [`vstest`](dotnet-vstest.md)
- [`pack`](dotnet-pack.md)
-- [`migrate`](dotnet-migrate.md)
- [`clean`](dotnet-clean.md)
- [`sln`](dotnet-sln.md)
- [`help`](dotnet-help.md)
diff --git a/docs/navigate/tools-diagnostics/toc.yml b/docs/navigate/tools-diagnostics/toc.yml
index 3b3baf4179a0e..bd5206dcaaf63 100644
--- a/docs/navigate/tools-diagnostics/toc.yml
+++ b/docs/navigate/tools-diagnostics/toc.yml
@@ -116,8 +116,6 @@ items:
href: ../../core/tools/dotnet-format.md
- name: dotnet help
href: ../../core/tools/dotnet-help.md
- - name: dotnet migrate
- href: ../../core/tools/dotnet-migrate.md
- name: dotnet msbuild
href: ../../core/tools/dotnet-msbuild.md
- name: dotnet new
From ec63fe8a4efc6e423f664f7602a8388727fb53a9 Mon Sep 17 00:00:00 2001
From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com>
Date: Mon, 6 Oct 2025 11:47:38 -0700
Subject: [PATCH 4/4] Investigate publishing issues with GHCP article (#48920)
* Empty commit for preview
* temp removal of toc items
* Revert "temp removal of toc items"
This reverts commit f2300e4e9e2e16cee73cdd82d67679519e9c16a5.