Skip to content

Improve messaging around .NET Upgrade Assistant #49674

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Improve messaging around .NET Upgrade Assistant #49674

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: 2 additions & 2 deletions docs/core/porting/includes/github-copilot-suggestion.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
author: adegeo
ms.author: adegeo
ms.date: 09/23/2025
ms.date: 11/07/2025
ms.topic: include
---

> [!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.
Copy link

Copilot AI Nov 7, 2025

Choose a reason for hiding this comment

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

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."

Copilot generated this review using guidance from repository custom instructions.
Copy link
Contributor Author

@adegeo adegeo Nov 7, 2025

Choose a reason for hiding this comment

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

@copilot open a new pull request to apply changes based on this feedback

Copy link
Contributor Author

@adegeo adegeo Nov 7, 2025

Choose a reason for hiding this comment

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

@copilot, update this PR with the suggestion in this feedback

2 changes: 2 additions & 0 deletions docs/core/porting/upgrade-assistant-how-to-analyze.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ ms.date: 10/08/2024

This article teaches you how to perform code analysis on your projects with .NET Upgrade Assistant, using Visual Studio or the terminal. The analysis generates a report that you can browse to get more information about the upgrade.

[!INCLUDE [github-copilot-suggestion](includes/github-copilot-suggestion.md)]

## Prerequisites

- For Visual Studio, see [Install .NET Upgrade Assistant - Visual Studio extension](upgrade-assistant-install.md#visual-studio-extension).
Expand Down
2 changes: 2 additions & 0 deletions docs/core/porting/upgrade-assistant-how-to-upgrade.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ ms.date: 10/08/2024

The focus of this article is to provide the basic steps to upgrade a project with .NET Upgrade Assistant. This involves initiating the upgrade and reviewing the results. Based on how complex your project is, you might be required to perform manual updates to your code.

[!INCLUDE [github-copilot-suggestion](includes/github-copilot-suggestion.md)]

Some project types have specific guidance on upgrading. For more information, see [Supported project types](upgrade-assistant-overview.md#supported-project-types).

## Prerequisites
Expand Down
16 changes: 0 additions & 16 deletions docs/core/porting/upgrade-assistant-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,22 +22,6 @@ ms.date: 10/08/2024

.NET Upgrade Assistant includes an analysis engine that scans your projects and their dependencies. After the scan is complete, a report is generated with detailed information about performing an upgrade. You can use this information to upgrade either the entire project or specific parts of the project.

<!-- I don't have this information ready yet

## Extensibility

One key feature of .NET Upgrade Assistant is designing upgrade extensions for your own libraries. Upgrade extensions can be made up of one or two upgrades:

- Package Map

This is something.

- API Map

This is something.

-->

## Supported project types

.NET Upgrade Assistant supports upgrading projects coded in either C# or Visual Basic. The following types of projects are supported:
Expand Down
2 changes: 2 additions & 0 deletions docs/core/porting/upgrade-assistant-telemetry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@ ms.date: 05/22/2023

The [Upgrade Assistant](./upgrade-assistant-overview.md) includes a telemetry feature that collects usage data. The telemetry data is used to help understand how to make improvements to the tool.

[!INCLUDE [github-copilot-suggestion](includes/github-copilot-suggestion.md)]

## How to opt out

The Upgrade Assistant telemetry feature is enabled by default. To opt out of the telemetry feature, set the `DOTNET_UPGRADEASSISTANT_TELEMETRY_OPTOUT` environment variable to `1` or `true`.
Expand Down
2 changes: 2 additions & 0 deletions docs/core/porting/upgrade-assistant-wcf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ The .NET Upgrade Assistant is a command-line tool that can assist with upgrading
- A demonstration of how to run the tool against a WCF Server-side project on .NET Framework.
- Troubleshooting tips.

[!INCLUDE [github-copilot-suggestion](includes/github-copilot-suggestion.md)]

## Things to know before starting

This tool currently supports C# projects and uses [CoreWCF](https://github.com/corewcf/corewcf) to port self-hosted WCF Server-side projects to .NET 6.
Expand Down
Loading