From 2a8befac6c5ae1b922b49cf3a0902bea60db54cc Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Fri, 7 Nov 2025 13:39:58 -0800 Subject: [PATCH] Alter include for upgrade assist; add to more articles --- .../includes/github-copilot-suggestion.md | 4 ++-- .../porting/upgrade-assistant-how-to-analyze.md | 2 ++ .../porting/upgrade-assistant-how-to-upgrade.md | 2 ++ docs/core/porting/upgrade-assistant-overview.md | 16 ---------------- docs/core/porting/upgrade-assistant-telemetry.md | 2 ++ docs/core/porting/upgrade-assistant-wcf.md | 2 ++ 6 files changed, 10 insertions(+), 18 deletions(-) diff --git a/docs/core/porting/includes/github-copilot-suggestion.md b/docs/core/porting/includes/github-copilot-suggestion.md index 1f413f4860abb..e4f2a4019a956 100644 --- a/docs/core/porting/includes/github-copilot-suggestion.md +++ b/docs/core/porting/includes/github-copilot-suggestion.md @@ -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. diff --git a/docs/core/porting/upgrade-assistant-how-to-analyze.md b/docs/core/porting/upgrade-assistant-how-to-analyze.md index afc1f1c76b59b..3bf3c9bd070af 100644 --- a/docs/core/porting/upgrade-assistant-how-to-analyze.md +++ b/docs/core/porting/upgrade-assistant-how-to-analyze.md @@ -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). diff --git a/docs/core/porting/upgrade-assistant-how-to-upgrade.md b/docs/core/porting/upgrade-assistant-how-to-upgrade.md index 6d266124364ba..9806ecc1174c4 100644 --- a/docs/core/porting/upgrade-assistant-how-to-upgrade.md +++ b/docs/core/porting/upgrade-assistant-how-to-upgrade.md @@ -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 diff --git a/docs/core/porting/upgrade-assistant-overview.md b/docs/core/porting/upgrade-assistant-overview.md index 5260ab914191b..5e594bc89e5a5 100644 --- a/docs/core/porting/upgrade-assistant-overview.md +++ b/docs/core/porting/upgrade-assistant-overview.md @@ -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. - - ## Supported project types .NET Upgrade Assistant supports upgrading projects coded in either C# or Visual Basic. The following types of projects are supported: diff --git a/docs/core/porting/upgrade-assistant-telemetry.md b/docs/core/porting/upgrade-assistant-telemetry.md index 4168be61f7309..be68747e9d2b9 100644 --- a/docs/core/porting/upgrade-assistant-telemetry.md +++ b/docs/core/porting/upgrade-assistant-telemetry.md @@ -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`. diff --git a/docs/core/porting/upgrade-assistant-wcf.md b/docs/core/porting/upgrade-assistant-wcf.md index 2552866ed2151..ce83e021f761a 100644 --- a/docs/core/porting/upgrade-assistant-wcf.md +++ b/docs/core/porting/upgrade-assistant-wcf.md @@ -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.