Skip to content

Remove references to the deprecated dotnet migrate command and add a … #48789

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

Closed
wants to merge 1 commit into from
Closed

Remove references to the deprecated dotnet migrate command and add a … #48789

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 4 additions & 0 deletions .openpublishing.redirection.core.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1516,6 +1516,10 @@
{
"source_path_from_root": "/docs/core/compatibility/sdk/9.0/nugetaudit-transitive-packages.md",
"redirect_url": "/dotnet/core/compatibility/sdk/10.0/nugetaudit-transitive-packages"
},
{
"source_path_from_root": "/docs/core/tools/dotnet-migrate.md",
"redirect_url": "/dotnet/core/porting"
}
]
}
4 changes: 1 addition & 3 deletions docs/core/compatibility/sdk/10.0/dotnet-restore-project-json-unsupported.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,16 +30,14 @@ 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` 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.

## Recommended action

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.

For more information about migrating from `project.json`, see [Migrating from project.json to .csproj](/nuget/archive/project-json#migrate-projectjson-to-packagereference).

## Affected APIs
Expand Down
103 changes: 0 additions & 103 deletions docs/core/tools/dotnet-migrate.md
View file
Open in desktop
Copy link
Contributor

Choose a reason for hiding this comment

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

Instead of deleting, can we archive this article? That way I can still point to it from the "Recommended action" section of the project.json breaking change. Using dotnet migrate was one of the recommended actions from the dev who logged the breaking change.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@gewarren! thanks for your feedback! I debated archiving instead of removing after seeing this command recommended in that breaking change. Let me look into a good location where I can archive this.

Copy link
Contributor

Choose a reason for hiding this comment

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

Use the archive instructions. It moves the content to a special repo: https://learn.microsoft.com/en-us/help/platform/archive-tool#open-the-archive-tool-in-ops

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@adegeo got it, thanks!

This file was deleted.

1 change: 0 additions & 1 deletion docs/core/tools/dotnet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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. |
Expand Down
1 change: 0 additions & 1 deletion docs/core/tools/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 0 additions & 2 deletions docs/navigate/tools-diagnostics/toc.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading