Clean up upgrade assistant - #52477
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the .NET Upgrade Assistant documentation to reflect the current Visual Studio experience (enablement via Options), refreshes dates and wording, removes outdated WCF guidance, and adjusts related assets.
Changes:
- Updated Upgrade Assistant articles to describe Visual Studio enablement and refreshed metadata dates.
- Removed the outdated WCF Upgrade Assistant article and updated related references within the Upgrade Assistant overview.
- Updated media assets for the new Visual Studio enablement flow.
Reviewed changes
Copilot reviewed 9 out of 12 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/core/porting/upgrade-assistant-wcf.md | Deletes an outdated WCF upgrade article. |
| docs/core/porting/upgrade-assistant-telemetry.md | Updates ms.date. |
| docs/core/porting/upgrade-assistant-overview.md | Updates wording, dates, and removes the WCF guidance link from the overview page. |
| docs/core/porting/upgrade-assistant-install.md | Reworks Visual Studio instructions toward enablement (Options toggle) and updates dates/verbiage. |
| docs/core/porting/upgrade-assistant-how-to-upgrade.md | Updates ms.date and adjusts prerequisites link text to match Visual Studio enablement. |
| docs/core/porting/upgrade-assistant-how-to-analyze.md | Updates ms.date and adjusts prerequisites link text to match Visual Studio enablement. |
| docs/core/porting/upgrade-assistant-analyze-overview.md | Updates ms.date and removes an old commented-out section. |
| docs/core/porting/media/upgrade-assistant-install/visual-studio-manage-extensions.png | Removes old screenshot (extension install flow). |
| docs/core/porting/media/upgrade-assistant-install/install-prompt.png | Removes old screenshot (extension install flow). |
| docs/core/porting/media/upgrade-assistant-install/enable.png | Adds new screenshot for the enablement flow. |
| docs/core/porting/includes/github-copilot-suggestion.md | Updates ms.date for the shared include. |
Comments suppressed due to low confidence (2)
docs/core/porting/includes/github-copilot-suggestion.md:9
- This include states “Visual Studio 2022 17.14.16 or later”, but the updated Upgrade Assistant install page lists “17.14.17+”. Please align the minimum supported VS version across the include and the Upgrade Assistant pages so readers don’t get conflicting requirements.
ms.date: 03/19/2026
ms.topic: include
---
> [!IMPORTANT]
> .NET Upgrade Assistant is officially deprecated. Use the [GitHub Copilot modernization chat agent](../github-copilot-app-modernization/overview.md) instead, which is included with Visual Studio 2026 and Visual Studio 2022 17.14.16 or later. This agent analyzes your projects and dependencies, produces a step-by-step migration plan with targeted recommendations and automated code fixes, and commits each change so you can validate or roll back. It automates common porting tasks—updating project files, replacing deprecated APIs, and resolving build issues—so you can modernize faster with less manual effort.
docs/core/porting/includes/github-copilot-suggestion.md:9
- The include calls .NET Upgrade Assistant “officially deprecated” and directs readers to Copilot modernization. Given the rest of the Upgrade Assistant docs still provide detailed usage instructions (and the linked issue notes the tool is available again via a VS toggle), consider softening/clarifying the support status (for example, “legacy” vs “deprecated”), and link to an official deprecation notice if that’s the intent.
> [!IMPORTANT]
> .NET Upgrade Assistant is officially deprecated. Use the [GitHub Copilot modernization chat agent](../github-copilot-app-modernization/overview.md) instead, which is included with Visual Studio 2026 and Visual Studio 2022 17.14.16 or later. This agent analyzes your projects and dependencies, produces a step-by-step migration plan with targeted recommendations and automated code fixes, and commits each change so you can validate or roll back. It automates common porting tasks—updating project files, replacing deprecated APIs, and resolving build issues—so you can modernize faster with less manual effort.
gewarren
approved these changes
Mar 19, 2026
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
adegeo
enabled auto-merge (squash)
March 20, 2026 18:05
auto-merge was automatically disabled
March 20, 2026 23:38
Pull request was closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Fixes #50261
Contributes to #52083
Internal previews