Improve messaging around .NET Upgrade Assistant #49674
Conversation
There was a problem hiding this comment.
Pull Request Overview
This PR updates documentation to communicate the deprecation of .NET Upgrade Assistant and its replacement by the GitHub Copilot app modernization chat agent. The changes add a prominent notice to key documentation pages and clean up outdated commented-out content.
- Updates the deprecation notice in the included suggestion file with current replacement information.
- Adds the deprecation notice to four key Upgrade Assistant documentation pages.
- Removes obsolete commented-out extensibility documentation.
Reviewed Changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| docs/core/porting/includes/github-copilot-suggestion.md | Updates deprecation message to reflect official deprecation and replacement details with Visual Studio version information |
| docs/core/porting/upgrade-assistant-wcf.md | Adds deprecation notice include after the introduction section |
| docs/core/porting/upgrade-assistant-telemetry.md | Adds deprecation notice include after the introduction section |
| docs/core/porting/upgrade-assistant-how-to-upgrade.md | Adds deprecation notice include after the introduction section |
| docs/core/porting/upgrade-assistant-how-to-analyze.md | Adds deprecation notice include after the introduction section |
| docs/core/porting/upgrade-assistant-overview.md | Removes unused commented-out extensibility section |
|
|
||
| > [!IMPORTANT] | ||
| > Try the [GitHub Copilot app modernization chat agent](../github-copilot-app-modernization/overview.md). 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. For more information, see [What is GitHub Copilot app modernization](../github-copilot-app-modernization/overview.md). | ||
| > .NET Upgrade Assistant is officially deprecated and has been replaced by [GitHub Copilot app modernization chat agent](../github-copilot-app-modernization/overview.md), 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. |
There was a problem hiding this comment.
The sentence doesn't lead with the most important information. According to the style guidelines, the most important information should come first. Consider restructuring to prioritize the deprecation notice and action item:
".NET Upgrade Assistant is officially deprecated. Use the GitHub Copilot app modernization chat agent 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."
There was a problem hiding this comment.
@copilot open a new pull request to apply changes based on this feedback
There was a problem hiding this comment.
@copilot, update this PR with the suggestion in this feedback
Summary
Related to #49654
Internal previews