diff --git a/.openpublishing.redirection.azure.json b/.openpublishing.redirection.azure.json index 4a235a8578772..f83d7b2becc3a 100644 --- a/.openpublishing.redirection.azure.json +++ b/.openpublishing.redirection.azure.json @@ -16,14 +16,6 @@ "source_path_from_root": "/docs/azure/dotnet-howto-migrate-vm.md", "redirect_url": "/dotnet/azure/migration/vm" }, - { - "source_path_from_root": "/docs/azure/migration/appmod/overview.md", - "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization-overview?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json" - }, - { - "source_path_from_root": "/docs/azure/migration/appmod/faq.md", - "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization-faq?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json" - }, { "source_path_from_root": "/docs/azure/migration/appmod/coding-agent-support.md", "redirect_url": "/dotnet/azure/migration/appmod/cloud-agent-support" diff --git a/.openpublishing.redirection.core.json b/.openpublishing.redirection.core.json index 225cad1072d97..1dd757973a086 100644 --- a/.openpublishing.redirection.core.json +++ b/.openpublishing.redirection.core.json @@ -1332,15 +1332,63 @@ }, { "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-faq.yml", - "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/faq" + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/faq" }, { "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-overview.md", - "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview" + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/best-practices.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/best-practices" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/concepts.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/concepts" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/customization.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/customization" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/faq.yml", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/faq" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/how-to-custom-upgrade-instructions.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/how-to-custom-upgrade-instructions" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/index.yml", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/install.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/install" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/overview.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/scenarios-and-skills" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/troubleshooting.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/troubleshooting" + }, + { + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/working-with-agent.md", + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/working-with-agent" }, { "source_path_from_root": "/docs/core/porting/how-to-upgrade-with-github-copilot.md", - "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot" + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot" }, { "source_path_from_root": "/docs/core/porting/libraries.md", @@ -1360,7 +1408,7 @@ }, { "source_path_from_root": "/docs/core/porting/upgrade-assistant-install-legacy.md", - "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview" + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview" }, { "source_path_from_root": "/docs/core/porting/upgrade-assistant-uwp-framework.md", @@ -1368,7 +1416,7 @@ }, { "source_path_from_root": "/docs/core/porting/upgrade-assistant-wcf.md", - "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview" + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview" }, { "source_path_from_root": "/docs/core/porting/upgrade-assistant-winforms-framework.md", @@ -1397,7 +1445,7 @@ }, { "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-install.md", - "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview" + "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview" }, { "source_path_from_root": "/docs/core/preview3/tools/csproj.md", diff --git a/docs/azure/migration/appmod/containerization.md b/docs/azure/migration/appmod/containerization.md index e696e62db8a00..b99858e0e6c26 100644 --- a/docs/azure/migration/appmod/containerization.md +++ b/docs/azure/migration/appmod/containerization.md @@ -23,7 +23,7 @@ In this quickstart, you learn how to containerize your project using GitHub Copi Before you begin, make sure you have: -[!INCLUDE [github-copilot-app-modernization-prereqs](../../../includes/github-copilot-app-modernization-prereqs.md)] +[!INCLUDE [github-copilot-app-modernization-prereqs](./includes/github-copilot-app-modernization-prereqs.md)] ## Containerize your project diff --git a/docs/azure/migration/appmod/deploy.md b/docs/azure/migration/appmod/deploy.md index ce1f17ca86f6c..90e874dadfe26 100644 --- a/docs/azure/migration/appmod/deploy.md +++ b/docs/azure/migration/appmod/deploy.md @@ -14,7 +14,7 @@ In this quickstart, you learn how to deploy your project to Azure with GitHub Co ## Prerequisites -[!INCLUDE [github-copilot-app-modernization-prereqs](../../../includes/github-copilot-app-modernization-prereqs.md)] +[!INCLUDE [github-copilot-app-modernization-prereqs](./includes/github-copilot-app-modernization-prereqs.md)] ## Deploy your project diff --git a/docs/core/porting/github-copilot-app-modernization/faq.yml b/docs/azure/migration/appmod/faq.yml similarity index 71% rename from docs/core/porting/github-copilot-app-modernization/faq.yml rename to docs/azure/migration/appmod/faq.yml index 9e1fe02c9ece5..c52ed8d9ee43f 100644 --- a/docs/core/porting/github-copilot-app-modernization/faq.yml +++ b/docs/azure/migration/appmod/faq.yml @@ -4,7 +4,8 @@ metadata: description: "This article answers frequently asked questions about GitHub Copilot modernization for .NET." titleSuffix: "" ms.topic: faq - ms.date: 07/07/2026 + ms.date: 07/30/2026 + ms.custom: devx-track-dotnet title: GitHub Copilot modernization FAQ summary: | @@ -27,7 +28,7 @@ sections: questions: - question: What can the agent do? answer: | - GitHub Copilot modernization helps you upgrade your .NET (.NET, .NET Core, and .NET Framework) projects to newer versions of .NET. It also helps modernize services for Azure, upgrades dependencies, and fixes errors in code after the upgrade. The agent performs the following steps in a Copilot chat session: + GitHub Copilot modernization is focused on migrating and modernizing your .NET applications for Azure. It helps assess your app for Azure readiness, generates a migration plan, and guides you through the steps to deploy your app to Azure. The agent performs the following steps in a Copilot chat session: - Analyzes your projects and proposes a modernization plan. - Runs a series of tasks to modernize your projects according to the plan. @@ -36,6 +37,8 @@ sections: - Reports progress and allows access to code changes and logs. - Learns from your interactions during the session to improve subsequent transformations. + To upgrade your .NET projects to newer versions of .NET, GitHub Copilot modernization uses the [GitHub Copilot upgrade agent](../../../core/porting/github-copilot-upgrade/overview.md). + - question: What limitations are there? answer: | - The agent requires a local Git repository. @@ -52,7 +55,7 @@ sections: - question: Can I customize or guide the agent? answer: | - The agent uses customization Copilot provides, such as instruction files and skills. Customization is based on what your Copilot supports. The agent includes 30+ built-in modernization skills that load automatically based on the technologies detected in your codebase. You can also create custom skills and scenarios. For more information, see [Apply custom upgrade instructions](how-to-custom-upgrade-instructions.md). + The agent uses customization Copilot provides, such as instruction files and skills. Customization is based on what your Copilot supports. The agent includes 30+ built-in modernization skills that load automatically based on the technologies detected in your codebase. You can also create custom skills and scenarios. If you manually adjust a fix, provide additional instructions in chat, or update the Markdown in the plan file, the agent learns from that interaction in the short term. Preferences and decisions are saved to `scenario-instructions.md` in the `.github/upgrades/` folder so they persist across sessions. @@ -75,47 +78,6 @@ sections: answer: | Yes. In Visual Studio, select **Help** > **Privacy** > **Privacy Settings** > **"No, I would not like to participate."** Telemetry settings might vary by development environment. Check your tool's privacy settings for more information. - - name: Upgrade .NET apps - questions: - - question: What can the agent upgrade? - answer: | - GitHub Copilot modernization helps you upgrade your .NET projects or modernize them for Azure. The agent supports multiple scenarios beyond framework upgrades, including Aspire integration, SDK-style conversion, Newtonsoft.Json upgrade, SqlClient upgrade, Azure Functions upgrade, and Semantic Kernel to Microsoft Agent Framework upgrade. For a full reference, see [Scenarios and skills reference](scenarios-and-skills.md). - - The agent works with these project types: - - - Azure Functions - - Console apps and class libraries - - Web technologies such as: - - MVC - - Blazor - - Razor Pages - - Web API - - ASP.NET Web Forms - - Desktop technologies such as Windows Forms, Windows Presentation Foundation, and WinUI - - .NET MAUI and Xamarin - - Test projects such as MSTest, NUnit, and xUnit - - .NET Framework projects - - The agent supports both C# and Visual Basic. - - - question: What .NET versions can I upgrade to? - answer: | - The agent supports the following upgrade paths: - - [!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] - - - question: Can I use the agent offline? - answer: | - No. The agent requires an internet connection and the GitHub Copilot cloud infrastructure. The agent works with all Copilot subscription tiers, including the free tier. - - - question: Does the agent modify files outside the solution? - answer: | - No. The agent only modifies files within your workspace and the `.github/upgrades/` folder. Custom task data stays in your repository. - - - question: Can I partially accept the agent's changes? - answer: | - Yes. Because each task is committed separately, you can cherry-pick specific commits by using standard Git commands. Review the commit history with `git log --oneline` and use `git cherry-pick` to select individual changes. - - name: Migrate to Azure questions: - question: What can the agent migrate? diff --git a/docs/includes/github-copilot-app-modernization-prereqs.md b/docs/azure/migration/appmod/includes/github-copilot-app-modernization-prereqs.md similarity index 85% rename from docs/includes/github-copilot-app-modernization-prereqs.md rename to docs/azure/migration/appmod/includes/github-copilot-app-modernization-prereqs.md index 3b29ce838c131..0eadf88443b6e 100644 --- a/docs/includes/github-copilot-app-modernization-prereqs.md +++ b/docs/azure/migration/appmod/includes/github-copilot-app-modernization-prereqs.md @@ -1,9 +1,9 @@ --- -author: adegeo -ms.author: adegeo -ms.date: 03/04/2026 +author: alexwolfmsft +ms.author: alexwolf +ms.date: 07/30/2026 ms.topic: include -# Shared by Azure.NET app mod and .NET app mod +# Shared by Azure .NET app modernization articles --- - Windows Operating System. @@ -23,4 +23,4 @@ ms.topic: include - Code must be written in C#. > [!NOTE] -> These prerequisites apply to Visual Studio. For other development environments, see [Install GitHub Copilot modernization](../core/porting/github-copilot-app-modernization/install.md). +> These prerequisites apply to Visual Studio. For other development environments, see [Install GitHub Copilot modernization](../install.md). diff --git a/docs/azure/migration/appmod/includes/quickstart-visual-studio.md b/docs/azure/migration/appmod/includes/quickstart-visual-studio.md index b69b35457c2bd..1368b903704e8 100644 --- a/docs/azure/migration/appmod/includes/quickstart-visual-studio.md +++ b/docs/azure/migration/appmod/includes/quickstart-visual-studio.md @@ -5,7 +5,7 @@ ms.date: 01/22/2026 ## Prerequisites -[!INCLUDE [github-copilot-app-modernization-prereqs](../../../../includes/github-copilot-app-modernization-prereqs.md)] +[!INCLUDE [github-copilot-app-modernization-prereqs](./github-copilot-app-modernization-prereqs.md)] ## Assess app readiness @@ -95,4 +95,4 @@ Choose one of the predefined options and send it in the chat: - [Working with assessment](../working-with-assessment.md) - [Predefined Tasks](../predefined-tasks.md) -- [Frequently Asked Questions](../../../../core/porting/github-copilot-app-modernization/faq.yml) +- [Frequently Asked Questions](../faq.yml) diff --git a/docs/azure/migration/appmod/install.md b/docs/azure/migration/appmod/install.md new file mode 100644 index 0000000000000..767b41ae3aad3 --- /dev/null +++ b/docs/azure/migration/appmod/install.md @@ -0,0 +1,133 @@ +--- +title: Install GitHub Copilot modernization +description: "Learn how to install and set up GitHub Copilot modernization across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com." +ms.topic: install-set-up-deploy +ms.date: 07/30/2026 +ms.custom: devx-track-dotnet +ai-usage: ai-assisted +zone_pivot_groups: copilot-modernization-install + +#customer intent: As a developer, I want to install GitHub Copilot modernization so that I can modernize my .NET applications. + +--- + +# Install GitHub Copilot modernization + +GitHub Copilot modernization works across multiple development environments. Choose your preferred environment to install and set up GitHub Copilot modernization. + +::: zone pivot="visualstudio" + +## Prerequisites + +Before you install, make sure you have: + +- Windows operating system. +- [Visual Studio 2026](https://visualstudio.microsoft.com/downloads/) (or Visual Studio 2022 version 17.14.17+). +- [.NET desktop development workload](/visualstudio/install/modify-visual-studio?view=visualstudio&preserve-view=true#change-workloads-or-individual-components) with these optional components enabled: **GitHub Copilot**, **GitHub Copilot app modernization**. +- GitHub Copilot subscription (paid or free). +- [Sign in to Visual Studio with a GitHub account](/visualstudio/ide/work-with-github-accounts) that has [Copilot access](https://docs.github.com/copilot/get-started/plans#ready-to-choose-a-plan). +- Code written in C# or Visual Basic. + +## Install + +Visual Studio includes GitHub Copilot modernization through the **GitHub Copilot app modernization** optional component, so you don't need to install it separately. Enable the **GitHub Copilot** and **GitHub Copilot app modernization** optional components in the **.NET desktop development** workload through the Visual Studio Installer. + +## Verify the installation + +1. Open a solution in Visual Studio. +1. Right-click a project in **Solution Explorer** and select **Modernize**, or open **GitHub Copilot Chat** and type `@Modernize`. + +::: zone-end + +::: zone pivot="vscode" + +## Prerequisites + +Before you install, make sure you have: + +- Visual Studio Code. +- GitHub Copilot extension installed. +- GitHub Copilot subscription (paid or free). + +## Install + +Install as a Visual Studio Code extension: + +1. In Visual Studio Code, open the **Extensions** view (Ctrl+Shift+X). +1. Search for **GitHub Copilot modernization**. +1. Select **Install**. + +## Verify the installation + +1. Open a project in Visual Studio Code. +1. Open the **GitHub Copilot Chat** view. +1. Send `@modernize` in chat and confirm the agent responds. + + -or- + + Select the **Agent** picker and find the `Modernize` entry. + +::: zone-end + +::: zone pivot="copilot-cli" + +## Prerequisites + +Before you install, make sure you have: + +- [GitHub Copilot CLI](https://gh.io/cli) installed. +- GitHub Copilot subscription (paid or free). + +## Install + +Install through the GitHub Copilot CLI: + +1. Open the GitHub Copilot chat window. + +1. Add the marketplace plugin: + + ```console + /plugin marketplace add microsoft/github-copilot-modernization + ``` + +1. Install the plugin: + + ```console + /plugin install github-copilot-modernization@github-copilot-modernization + ``` + +## Verify the installation + +Run `/plugin list` to confirm that `github-copilot-modernization@github-copilot-modernization` appears in the list. + +::: zone-end + +::: zone pivot="github-copilot-app" + +## Prerequisites + +Before you install, make sure you have: + +- [GitHub Copilot app](https://gh.io/app) installed. +- GitHub Copilot subscription (paid or free). + +## Install + +Install through the GitHub Copilot app: + +1. Click [https://github.com/copilot/app/launch](https://github.com/copilot/app/launch?entry_point=modernization_agent_dotnetdocs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Fgithub-copilot-modernization) to automatically open the **Settings** > **Plugins** window in the GitHub Copilot app. +1. In the **Add plugin marketplace?** dialog, select **Allow**. +1. In the **Plugins** window, select **Add marketplace**. +1. Expand the **github-copilot-modernization** entry and select **Install** on the **github-copilot-modernization** plugin. + +## Verify the installation + +Run `/agent` to confirm that the new agent appears in the agent list. + +::: zone-end + +## Related content + +- [GitHub Copilot modernization FAQ](faq.yml) +- [Quickstart: Assess and migrate a .NET project with GitHub Copilot modernization for .NET](quickstart.md) +- [Application assessment with GitHub Copilot modernization](working-with-assessment.md) diff --git a/docs/core/porting/github-copilot-app-modernization/overview.md b/docs/azure/migration/appmod/overview.md similarity index 69% rename from docs/core/porting/github-copilot-app-modernization/overview.md rename to docs/azure/migration/appmod/overview.md index 14297194b8c58..d8f28df09a11d 100644 --- a/docs/core/porting/github-copilot-app-modernization/overview.md +++ b/docs/azure/migration/appmod/overview.md @@ -1,9 +1,10 @@ --- title: GitHub Copilot modernization overview -description: "Learn about GitHub Copilot modernization, a Copilot agent available across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com that upgrades .NET projects and migrates apps to Azure." +description: "Learn about GitHub Copilot modernization, a Copilot agent that migrates .NET applications to Azure through automated assessment, AI-driven code remediation, and deployment automation." titleSuffix: "" ms.topic: overview -ms.date: 07/07/2026 +ms.date: 07/30/2026 +ms.custom: devx-track-dotnet ai-usage: ai-assisted #customer intent: As a developer, I want to learn about what GitHub Copilot modernization is, so that I understand its capabilities and how I can take advantage of it. @@ -12,35 +13,23 @@ ai-usage: ai-assisted # What is GitHub Copilot modernization? -GitHub Copilot modernization is a GitHub Copilot agent that helps you upgrade projects to newer versions of .NET and migrate .NET applications to Azure quickly and confidently. It guides you through assessment, solution recommendations, code fixes, and validation across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com. +GitHub Copilot modernization is a GitHub Copilot agent that migrates .NET applications to Azure quickly and confidently. It guides you through assessment, solution recommendations, code fixes, and deployment across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com. Use this agent to: -- Upgrade to a newer version of .NET. - Migrate technologies and deploy to Azure. -- Modernize your .NET app, especially when upgrading from .NET Framework. -- Assess your application's code, configuration, and dependencies. -- Plan and set up the right Azure resource. +- Assess your application's code, configuration, and dependencies for Azure readiness. +- Plan and set up the right Azure resources. - Fix issues and apply best practices for cloud migration. -- Validate that your app builds and tests successfully. +- Validate that your app builds and tests successfully after migration. + +When your migration requires upgrading to a newer version of .NET, the modernization agent invokes [GitHub Copilot upgrade](../../../core/porting/github-copilot-upgrade/overview.md) to handle the version upgrade. ## Scenarios -The agent provides multiple end-to-end modernization workflows called _scenarios_. Each scenario is a managed workflow that guides you through a specific type of upgrade or migration: +The agent provides predefined migration scenarios for common Azure targets. For a full reference, see the [Predefined tasks for migration](#predefined-tasks-for-migration) section below. -| Scenario | Description | Example prompt | -|---|---|---| -| **.NET version upgrade** | Upgrades from older .NET versions to .NET 8, 9, 10, or later. | _"Upgrade my solution to .NET 10"_ | -| **SDK-style conversion** | Converts legacy project format to SDK-style. | _"Convert to SDK-style"_ | -| **Newtonsoft.Json upgrade** | Replaces Newtonsoft.Json with System.Text.Json. | _"Upgrade from Newtonsoft.Json"_ | -| **SqlClient upgrade** | Upgrades from System.Data.SqlClient to Microsoft.Data.SqlClient. | _"Update SqlClient"_ | -| **Azure Functions upgrade** | Upgrades Azure Functions from in-process to isolated worker model. | _"Upgrade my Azure Functions"_ | -| **Semantic Kernel to Agents** | Upgrades Semantic Kernel Agents to Microsoft Agent Framework. | _"Upgrade my SK agents"_ | -| **Aspire integration** | Adds [Aspire](https://aspire.dev) support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | -| **Aspire version upgrade** | Upgrades existing Aspire applications to newer versions. | _"Upgrade my Aspire version"_ | -| **WebForms-to-Blazor upgrade** | Upgrades ASP.NET Web Forms applications to Blazor. | _"Migrate my Web Forms app to Blazor"_ | - -For a full reference of all scenarios and 30+ built-in upgrade skills, see [Scenarios and skills reference](scenarios-and-skills.md). +When a migration requires upgrading the .NET version, the modernization agent coordinates with [GitHub Copilot upgrade](../../../core/porting/github-copilot-upgrade/overview.md) to perform the version upgrade as part of the migration workflow. ## Provide feedback @@ -54,30 +43,6 @@ Microsoft values your feedback and uses it to improve the agent. Leave feedback Set up GitHub Copilot modernization in your development environment before using the agent. For installation steps, see [Install GitHub Copilot modernization](install.md). -## Upgrade .NET projects - -The modernization agent supports upgrading C# and Visual Basic projects of the following types: - -- ASP.NET Core (and related technologies such as MVC, Razor Pages, and Web API) -- ASP.NET Web Forms -- Blazor -- Azure Functions -- Windows Presentation Foundation (WPF) -- Windows Forms -- WinUI -- .NET MAUI and Xamarin -- Class libraries -- Console apps -- Test projects (MSTest, NUnit, and xUnit) - -To start an upgrade, see [Upgrade a .NET app with GitHub Copilot modernization](how-to-upgrade-with-github-copilot.md). - -### Supported upgrade paths - -The agent supports the following upgrade paths: - -[!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] - ## Migrate .NET projects to Azure The modernization agent simplifies Azure migrations through automated analysis, AI-driven code remediation, build and vulnerability checks, and deployment automation: @@ -142,13 +107,13 @@ GitHub Copilot modernization for .NET offers predefined tasks that capture indus Replace in-memory or local Redis cache implementations with Azure Cache for Redis for high availability, scalability, and enterprise-grade security. -## How it works +## Upgrade .NET projects -To start an upgrade or migration process, see: +When your migration requires upgrading your .NET projects to a newer version, the GitHub Copilot modernization agent calls [GitHub Copilot upgrade](../../../core/porting/github-copilot-upgrade/overview.md) to perform the version upgrade. The upgrade runs as part of the overall modernization workflow. For more information about what the upgrade agent supports, see [What is GitHub Copilot upgrade?](../../../core/porting/github-copilot-upgrade/overview.md). -[!INCLUDE[github-copilot-how-to-initiate](./includes/how-to-initiate.md)] +## How it works -When you ask the modernization agent to upgrade your app, Copilot first prompts you to create a new branch if you're working in a Git repository. Then Copilot assesses your project and runs a three-stage workflow. Each stage produces Markdown files under `.github/upgrades/{scenarioId}` in your repository so you can review what comes next before you continue. If `.github/upgrades/{scenarioId}` already exists from a prior attempt, Copilot asks whether to continue or start fresh. +When you ask the modernization agent to modernize your app, Copilot first prompts you to create a new branch if you're working in a Git repository. Then Copilot assesses your project and runs a three-stage workflow. Each stage produces Markdown files under `.github/upgrades/{scenarioId}` in your repository so you can review what comes next before you continue. If `.github/upgrades/{scenarioId}` already exists from a prior attempt, Copilot asks whether to continue or start fresh. Copilot starts by examining your project structure, dependencies, and code patterns to build a comprehensive assessment. The `assessment.md` file lists breaking changes, API compatibility problems, deprecated patterns, and the upgrade scope. @@ -219,10 +184,5 @@ The tool collects data about project types, intent to upgrade, and upgrade durat ## Related content - [Install GitHub Copilot modernization](install.md) -- [Upgrade a .NET app with GitHub Copilot modernization](how-to-upgrade-with-github-copilot.md) -- [Core concepts](concepts.md) -- [Scenarios and skills reference](scenarios-and-skills.md) -- [Best practices](best-practices.md) -- [Troubleshoot GitHub Copilot modernization](troubleshooting.md) -- [Quickstart: Migrate a .NET project to Azure](../../../azure/migration/appmod/quickstart.md) +- [Quickstart: Migrate a .NET project to Azure](quickstart.md) - [GitHub Copilot modernization FAQ](faq.yml) diff --git a/docs/azure/migration/appmod/quickstart.md b/docs/azure/migration/appmod/quickstart.md index 94def9aa04889..e5c5f79d4f732 100644 --- a/docs/azure/migration/appmod/quickstart.md +++ b/docs/azure/migration/appmod/quickstart.md @@ -31,4 +31,4 @@ In this quickstart, you assess and migrate a .NET project by using GitHub Copilo ## Next Steps - [Predefined Tasks](predefined-tasks.md) -- [GitHub Copilot modernization FAQ](../../../core/porting/github-copilot-app-modernization/faq.yml) +- [GitHub Copilot modernization FAQ](./faq.yml) diff --git a/docs/azure/migration/appmod/working-with-assessment.md b/docs/azure/migration/appmod/working-with-assessment.md index 55dff30c0a187..5afca472e0f9c 100644 --- a/docs/azure/migration/appmod/working-with-assessment.md +++ b/docs/azure/migration/appmod/working-with-assessment.md @@ -132,4 +132,4 @@ You can select the `Export` button in the assessment dashboard to export the rep ## Next Steps - [Predefined Tasks](predefined-tasks.md) -- [Frequently Asked Questions](../../../core/porting/github-copilot-app-modernization/faq.yml) +- [Frequently Asked Questions](./faq.yml) diff --git a/docs/azure/toc.yml b/docs/azure/toc.yml index f8763b7a4ed2a..6abc5a69fc88b 100644 --- a/docs/azure/toc.yml +++ b/docs/azure/toc.yml @@ -27,7 +27,7 @@ items: - name: GitHub Copilot modernization for .NET items: - name: Overview - href: ../core/porting/github-copilot-app-modernization/overview.md?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ./migration/appmod/overview.md - name: Quickstart - Assess and migrate a .NET project href: ./migration/appmod/quickstart.md - name: Assessment guide @@ -44,8 +44,10 @@ items: href: ./migration/appmod/copilot-cli-support.md - name: Sample - Contoso University href: ./migration/appmod/sample.md + - name: Install + href: ./migration/appmod/install.md - name: FAQ - href: ../core/porting/github-copilot-app-modernization/faq.yml?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ./migration/appmod/faq.yml - name: Azure Migrate application and code assessment items: - name: Overview diff --git a/docs/core/install/upgrade.md b/docs/core/install/upgrade.md index 35675d39ad5ab..b6c3e7cb6505e 100644 --- a/docs/core/install/upgrade.md +++ b/docs/core/install/upgrade.md @@ -40,7 +40,7 @@ Here's how to do it: - The same pattern applies for the `` property if it is being used. > [!TIP] -> The [GitHub Copilot modernization](../porting/github-copilot-app-modernization/overview.md) chat agent can make these changes automatically. +> The [GitHub Copilot modernization](../porting/github-copilot-upgrade/overview.md) chat agent can make these changes automatically. The next step is to build the project (or solution) with the new SDK. If additional changes are needed, the SDK will provide warnings and errors that guide you. diff --git a/docs/core/porting/framework-overview.md b/docs/core/porting/framework-overview.md index 79e139ce0a9c3..061674a874e6a 100644 --- a/docs/core/porting/framework-overview.md +++ b/docs/core/porting/framework-overview.md @@ -125,7 +125,7 @@ Even if you use a tool to help port your application, you should review the [Con ### GitHub Copilot modernization agent -[GitHub Copilot modernization](github-copilot-app-modernization/overview.md) is a GitHub Copilot chat agent that helps you plan and upgrade projects to newer versions of .NET, migrate to Azure, update dependencies, and apply code fixes. Azure migration is powered by [Application and code assessment for .NET](../../azure/migration/appcat/app-code-assessment-toolkit.md) +[GitHub Copilot modernization](github-copilot-upgrade/overview.md) is a GitHub Copilot chat agent that helps you plan and upgrade projects to newer versions of .NET, migrate to Azure, update dependencies, and apply code fixes. Azure migration is powered by [Application and code assessment for .NET](../../azure/migration/appcat/app-code-assessment-toolkit.md) This chat agent supports the following upgrade paths: @@ -190,7 +190,7 @@ For more information, see [Platform compatibility analyzer](../../standard/analy When porting your application to .NET, consider the following suggestions in order: -✔️ CONSIDER using the [GitHub Copilot modernization](github-copilot-app-modernization/overview.md) to upgrade your projects. GitHub Copilot is powerful at identifying and fixing incompatibilities when porting. It automates most of the manual steps detailed in this article and gives you a great starting point for continuing your upgrade path. +✔️ CONSIDER using the [GitHub Copilot modernization](github-copilot-upgrade/overview.md) to upgrade your projects. GitHub Copilot is powerful at identifying and fixing incompatibilities when porting. It automates most of the manual steps detailed in this article and gives you a great starting point for continuing your upgrade path. ✔️ CONSIDER examining your dependencies first. Your dependencies must target .NET, .NET Standard, or .NET Core. @@ -210,7 +210,7 @@ When porting your application to .NET, consider the following suggestions in ord ## See also -- [What is GitHub Copilot modernization](github-copilot-app-modernization/overview.md) +- [What is GitHub Copilot modernization](github-copilot-upgrade/overview.md) - [ASP.NET to ASP.NET Core migration](/aspnet/core/migration/proper-to-2x) - [Upgrade a WPF desktop app to .NET](/dotnet/desktop/wpf/migration/) - [Upgrade a Windows Forms app to .NET](/dotnet/desktop/winforms/migration/) diff --git a/docs/core/porting/github-copilot-app-modernization/best-practices.md b/docs/core/porting/github-copilot-upgrade/best-practices.md similarity index 94% rename from docs/core/porting/github-copilot-app-modernization/best-practices.md rename to docs/core/porting/github-copilot-upgrade/best-practices.md index 78325af1d934c..17874b5831878 100644 --- a/docs/core/porting/github-copilot-app-modernization/best-practices.md +++ b/docs/core/porting/github-copilot-upgrade/best-practices.md @@ -1,17 +1,17 @@ --- -title: Best practices for GitHub Copilot modernization -description: "Learn best practices for using GitHub Copilot modernization to upgrade .NET projects, including preparation, collaboration tips, common pitfalls, and recovery strategies." +title: Best practices for GitHub Copilot upgrade +description: "Learn best practices for using GitHub Copilot upgrade to upgrade .NET projects, including preparation, collaboration tips, common pitfalls, and recovery strategies." ms.topic: best-practice ms.date: 07/07/2026 ai-usage: ai-assisted -#customer intent: As a developer, I want to follow best practices when using GitHub Copilot modernization so that I can get the best results from my .NET upgrades and avoid common problems. +#customer intent: As a developer, I want to follow best practices when using GitHub Copilot upgrade so that I can get the best results from my .NET upgrades and avoid common problems. --- -# Best practices for GitHub Copilot modernization +# Best practices for GitHub Copilot upgrade -Follow these guidelines to get the best results from GitHub Copilot modernization when upgrading .NET projects. +Follow these guidelines to get the best results from GitHub Copilot upgrade when upgrading .NET projects. ## Before you start @@ -224,7 +224,7 @@ Your original code is untouched. If you're working without source control, resto ## Related content -- [What is GitHub Copilot modernization?](overview.md) -- [Upgrade a .NET app with GitHub Copilot modernization](how-to-upgrade-with-github-copilot.md) +- [What is GitHub Copilot upgrade?](overview.md) +- [Upgrade a .NET app with GitHub Copilot upgrade](how-to-upgrade-with-github-copilot.md) - [Core concepts](concepts.md) -- [Troubleshoot GitHub Copilot modernization](troubleshooting.md) +- [Troubleshoot GitHub Copilot upgrade](troubleshooting.md) diff --git a/docs/core/porting/github-copilot-app-modernization/concepts.md b/docs/core/porting/github-copilot-upgrade/concepts.md similarity index 90% rename from docs/core/porting/github-copilot-app-modernization/concepts.md rename to docs/core/porting/github-copilot-upgrade/concepts.md index 25e0466d52534..367ec09e211a1 100644 --- a/docs/core/porting/github-copilot-app-modernization/concepts.md +++ b/docs/core/porting/github-copilot-upgrade/concepts.md @@ -1,17 +1,17 @@ --- -title: GitHub Copilot modernization core concepts -description: "Learn the key concepts behind GitHub Copilot modernization, including scenarios, skills, tasks, the three-stage workflow, state management, and flow modes." +title: GitHub Copilot upgrade core concepts +description: "Learn the key concepts behind GitHub Copilot upgrade, including scenarios, skills, tasks, the three-stage workflow, state management, and flow modes." ms.topic: concept-article ms.date: 07/07/2026 ai-usage: ai-assisted -#customer intent: As a developer, I want to understand the core concepts of GitHub Copilot modernization so that I can use the agent effectively and get the best results from my upgrades. +#customer intent: As a developer, I want to understand the core concepts of GitHub Copilot upgrade so that I can use the agent effectively and get the best results from my upgrades. --- -# GitHub Copilot modernization concepts +# GitHub Copilot upgrade concepts -GitHub Copilot modernization uses a structured approach to upgrade .NET projects. Understanding how the agent works, including its scenarios, skills, tasks, and workflow, helps you collaborate with the agent effectively and get the best results. +GitHub Copilot upgrade uses a structured approach to upgrade .NET projects. Understanding how the agent works, including its scenarios, skills, tasks, and workflow, helps you collaborate with the agent effectively and get the best results. > [!TIP] > Think of the agent as a skilled colleague who understands .NET deeply, follows a structured plan, and adapts to your feedback. The more context you give, the better the agent performs. @@ -28,7 +28,7 @@ The agent excels at collaboration, not automation in a vacuum: ## Scenarios -A _scenario_ is a managed, end-to-end modernization workflow. When you tell the agent "upgrade my solution to .NET 10," you're triggering the `.NET version upgrade` scenario. +A _scenario_ is a managed, end-to-end upgrade workflow. When you tell the agent "upgrade my solution to .NET 10," you're triggering the `.NET version upgrade` scenario. ### How scenarios are discovered @@ -207,8 +207,8 @@ Best for first-time users, complex solutions, and when you want to learn the pro ## Related content -- [What is GitHub Copilot modernization?](overview.md) +- [What is GitHub Copilot upgrade?](overview.md) - [Scenarios and skills reference](scenarios-and-skills.md) -- [Upgrade a .NET app with GitHub Copilot modernization](how-to-upgrade-with-github-copilot.md) +- [Upgrade a .NET app with GitHub Copilot upgrade](how-to-upgrade-with-github-copilot.md) - [Best practices](best-practices.md) -- [Troubleshoot GitHub Copilot modernization](troubleshooting.md) +- [Troubleshoot GitHub Copilot upgrade](troubleshooting.md) diff --git a/docs/core/porting/github-copilot-app-modernization/customization.md b/docs/core/porting/github-copilot-upgrade/customization.md similarity index 95% rename from docs/core/porting/github-copilot-app-modernization/customization.md rename to docs/core/porting/github-copilot-upgrade/customization.md index e126092689312..50e1acce6d729 100644 --- a/docs/core/porting/github-copilot-app-modernization/customization.md +++ b/docs/core/porting/github-copilot-upgrade/customization.md @@ -1,17 +1,17 @@ --- -title: Customize GitHub Copilot modernization -description: "Learn how to customize GitHub Copilot modernization with custom skills, custom scenarios, scenario artifact edits, and chat instructions to encode your team's upgrade patterns." +title: Customize GitHub Copilot upgrade +description: "Learn how to customize GitHub Copilot upgrade with custom skills, custom scenarios, scenario artifact edits, and chat instructions to encode your team's upgrade patterns." ms.topic: concept-article ms.date: 07/07/2026 ai-usage: ai-assisted -#customer intent: As a developer, I want to customize GitHub Copilot modernization so that I can encode my team's upgrade patterns, enforce coding standards during upgrades, and define custom upgrade workflows. +#customer intent: As a developer, I want to customize GitHub Copilot upgrade so that I can encode my team's upgrade patterns, enforce coding standards during upgrades, and define custom upgrade workflows. --- -# Customize GitHub Copilot modernization +# Customize GitHub Copilot upgrade -GitHub Copilot modernization is extensible. The agent provides multiple customization points to encode your team's upgrade patterns, enforce coding standards during upgrades, and define new upgrade workflows. +GitHub Copilot upgrade is extensible. The agent provides multiple customization points to encode your team's upgrade patterns, enforce coding standards during upgrades, and define new upgrade workflows. ## Customization points overview diff --git a/docs/core/porting/github-copilot-upgrade/faq.yml b/docs/core/porting/github-copilot-upgrade/faq.yml new file mode 100644 index 0000000000000..a90425bb83c6d --- /dev/null +++ b/docs/core/porting/github-copilot-upgrade/faq.yml @@ -0,0 +1,128 @@ +### YamlMime:FAQ +metadata: + title: GitHub Copilot upgrade for .NET FAQ + description: "This article answers frequently asked questions about GitHub Copilot upgrade for .NET." + titleSuffix: "" + ms.topic: faq + ms.date: 07/07/2026 + +title: GitHub Copilot upgrade FAQ +summary: | + GitHub Copilot upgrade is an interactive GitHub Copilot agent that adds capabilities to your development environment. This article answers frequently asked questions. For more information, see [What is GitHub Copilot upgrade](overview.md). + + The tool requires one of the following GitHub Copilot subscriptions: + + - Copilot Free (Starting with Visual Studio 2026 version 18.1) + - Copilot Pro + - Copilot Pro+ + - Copilot Business + - Copilot Enterprise + + GitHub Copilot upgrade is available in Visual Studio, Visual Studio Code, GitHub Copilot CLI, and on GitHub.com. For Visual Studio, it's included in [Visual Studio 2026](https://visualstudio.microsoft.com/downloads/) (or Visual Studio 2022 version 17.14.17 and newer). + + For more information about installation, [Install GitHub Copilot upgrade](install.md). + +sections: + - name: Upgrade agent + questions: + - question: What can the agent do? + answer: | + GitHub Copilot upgrade helps you upgrade your .NET (.NET, .NET Core, and .NET Framework) projects to newer versions of .NET. It upgrades dependencies and fixes errors in code after the upgrade. The agent performs the following steps in a Copilot chat session: + + - Analyzes your projects and proposes an upgrade plan. + - Runs a series of tasks to upgrade your projects according to the plan. + - Operates in a working branch under a local Git repository. + - Fixes issues automatically during the code transformation. + - Reports progress and allows access to code changes and logs. + - Learns from your interactions during the session to improve subsequent transformations. + + - question: What limitations are there? + answer: | + - The agent requires a local Git repository. + - The upgrade suggestions aren't guaranteed to follow best practices. + - Code fixes and corrections you provide to Copilot during the upgrade process don't persist and aren't remembered for future upgrades. + + - question: Which model should I use? + answer: | + Use a good coding model. Model availability is dependent on your Copilot subscription and environment. For a comparison of models, see [GitHub Copilot AI model comparison](https://docs.github.com/copilot/reference/ai-models/model-comparison). + + - question: Can I train the model based on my code base? + answer: | + No. Unlike traditional AI tools where you might enter freeform prompts, the agent operates in a structured way. The AI is embedded in the build-and-fix process, so the prompts it uses are predefined and tied to the upgrade plan. You can't train it on your codebase, but it's used as context by the agent. + + - question: Can I customize or guide the agent? + answer: | + The agent uses customization Copilot provides, such as instruction files and skills. Customization is based on what your Copilot supports. The agent includes 30+ built-in upgrade skills that load automatically based on the technologies detected in your codebase. You can also create custom skills and scenarios. For more information, see [Apply custom upgrade instructions](how-to-custom-upgrade-instructions.md). + + If you manually adjust a fix, provide additional instructions in chat, or update the Markdown in the plan file, the agent learns from that interaction in the short term. Preferences and decisions are saved to `scenario-instructions.md` in the `.github/upgrades/` folder so they persist across sessions. + + - question: Does the agent store my source code? + answer: | + The agent never stores your codebase or uses your code to train the model. Once an upgrade completes, the agent deletes session data. + + - question: Can I provide feedback? + answer: | + Yes! There are two ways to provide feedback: + + - In Visual Studio, use the [Suggest a feature](/visualstudio/ide/suggest-a-feature) and [Report a Problem](/visualstudio/ide/report-a-problem) features. + - File an issue at the [upgrade-agent-plugins GitHub repository](https://github.com/microsoft/upgrade-agent-plugins). + + - question: What data is collected? + answer: | + The agent collects telemetry only about project types, intent to upgrade, and upgrade duration. The data is aggregated through your development environment and doesn't contain user-identifiable information. For more information about Microsoft's privacy policy, see [Visual Studio Customer Experience Improvement Program](/visualstudio/ide/visual-studio-experience-improvement-program?view=visualstudio&preserve-view=true). + + - question: Can I disable telemetry? + answer: | + Yes. In Visual Studio, select **Help** > **Privacy** > **Privacy Settings** > **"No, I would not like to participate."** Telemetry settings might vary by development environment. Check your tool's privacy settings for more information. + + - name: Upgrade .NET apps + questions: + - question: What can the agent upgrade? + answer: | + GitHub Copilot upgrade helps you upgrade your .NET projects. The agent supports multiple scenarios beyond framework upgrades, including Aspire integration, SDK-style conversion, Newtonsoft.Json upgrade, SqlClient upgrade, Azure Functions upgrade, and Semantic Kernel to Microsoft Agent Framework upgrade. For a full reference, see [Scenarios and skills reference](scenarios-and-skills.md). + + The agent works with these project types: + + - Azure Functions + - Console apps and class libraries + - Web technologies such as: + - MVC + - Blazor + - Razor Pages + - Web API + - ASP.NET Web Forms + - Desktop technologies such as Windows Forms, Windows Presentation Foundation, and WinUI + - .NET MAUI and Xamarin + - Test projects such as MSTest, NUnit, and xUnit + - .NET Framework projects + + The agent supports both C# and Visual Basic. + + - question: What .NET versions can I upgrade to? + answer: | + The agent supports the following upgrade paths: + + [!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] + + - question: Can I use the agent offline? + answer: | + No. The agent requires an internet connection and the GitHub Copilot cloud infrastructure. The agent works with all Copilot subscription tiers, including the free tier. + + - question: Does the agent modify files outside the solution? + answer: | + No. The agent only modifies files within your workspace and the `.github/upgrades/` folder. Custom task data stays in your repository. + + - question: Can I partially accept the agent's changes? + answer: | + Yes. Because each task is committed separately, you can cherry-pick specific commits by using standard Git commands. Review the commit history with `git log --oneline` and use `git cherry-pick` to select individual changes. + + - name: Migrate to Azure + questions: + - question: Can GitHub Copilot upgrade migrate my app to Azure? + answer: | + Azure migration scenarios are handled by the GitHub Copilot modernization agent. For more information, see [GitHub Copilot modernization overview](../../../azure/migration/appmod/overview.md). + +additionalContent: | + ## Related content + + To learn more, see [What is GitHub Copilot upgrade?](overview.md). diff --git a/docs/core/porting/github-copilot-app-modernization/how-to-custom-upgrade-instructions.md b/docs/core/porting/github-copilot-upgrade/how-to-custom-upgrade-instructions.md similarity index 87% rename from docs/core/porting/github-copilot-app-modernization/how-to-custom-upgrade-instructions.md rename to docs/core/porting/github-copilot-upgrade/how-to-custom-upgrade-instructions.md index 2bba426764314..a17ba992aa982 100644 --- a/docs/core/porting/github-copilot-app-modernization/how-to-custom-upgrade-instructions.md +++ b/docs/core/porting/github-copilot-upgrade/how-to-custom-upgrade-instructions.md @@ -1,6 +1,6 @@ --- title: Apply custom upgrade instructions for .NET upgrades -description: "Create and apply custom upgrade instructions with GitHub Copilot modernization to automate .NET upgrades. Write, test, and integrate instructions for consistent transformations." +description: "Create and apply custom upgrade instructions with GitHub Copilot upgrade to automate .NET upgrades. Write, test, and integrate instructions for consistent transformations." author: kschlobohm ms.topic: how-to ms.date: 03/04/2026 @@ -12,17 +12,17 @@ ai-usage: ai-assisted # Apply custom upgrade instructions for .NET upgrades -Custom upgrade instructions are Markdown files that guide GitHub Copilot modernization to apply specific transformations during an upgrade. Create these files to automate repetitive changes, such as replacing one library with another or applying a specific API upgrade. +Custom upgrade instructions are Markdown files that guide GitHub Copilot upgrade to apply specific transformations during an upgrade. Create these files to automate repetitive changes, such as replacing one library with another or applying a specific API upgrade. This article explains how to create and structure a custom upgrade instruction file, test it in isolation, and integrate it into the assessment stage of an upgrade workflow. ## Prerequisites -Set up GitHub Copilot modernization in your development environment before creating custom instructions. For installation steps, see [Install GitHub Copilot modernization](install.md). +Set up GitHub Copilot upgrade in your development environment before creating custom instructions. For installation steps, see [Install GitHub Copilot upgrade](install.md). ## Understand custom upgrade instructions -GitHub Copilot modernization retrieves custom upgrade instructions as Markdown files on demand during the assessment and planning stages of an upgrade. Custom upgrade instructions differ from `copilot-instructions.md` because they're: +GitHub Copilot upgrade retrieves custom upgrade instructions as Markdown files on demand during the assessment and planning stages of an upgrade. Custom upgrade instructions differ from `copilot-instructions.md` because they're: - Targeted to automating code and dependency changes. - Retrieved only when relevant to the current upgrade assessment or plan. @@ -35,7 +35,7 @@ Structure your instruction files with: - Explicit step logic ("If X is found, do Y"). Avoid vague language. - (Recommended) One or more diff examples captured from actual local edits to guide transformations. -Beyond custom upgrade instructions, you can extend GitHub Copilot modernization through the standard skills and instructions system. Skills add capabilities to the agent, and instruction files (like `copilot-instructions.md`) provide global guidance. +Beyond custom upgrade instructions, you can extend GitHub Copilot upgrade through the standard skills and instructions system. Skills add capabilities to the agent, and instruction files (like `copilot-instructions.md`) provide global guidance. ## Create a custom upgrade instruction @@ -159,7 +159,7 @@ Remove or consolidate any temporary instruction files to avoid overlapping trans ## Related content -- [Upgrade a .NET app with GitHub Copilot modernization](how-to-upgrade-with-github-copilot.md) -- [GitHub Copilot modernization FAQ](faq.yml) -- [What is GitHub Copilot modernization?](overview.md) -- [Install GitHub Copilot modernization](install.md) +- [Upgrade a .NET app with GitHub Copilot upgrade](how-to-upgrade-with-github-copilot.md) +- [GitHub Copilot upgrade FAQ](faq.yml) +- [What is GitHub Copilot upgrade?](overview.md) +- [Install GitHub Copilot upgrade](install.md) diff --git a/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md b/docs/core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot.md similarity index 89% rename from docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md rename to docs/core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot.md index 834cb6d0e5e27..c746881d90e86 100644 --- a/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md +++ b/docs/core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot.md @@ -1,23 +1,23 @@ --- -title: How to upgrade a .NET app with GitHub Copilot modernization -description: "Learn how to upgrade your .NET applications to newer versions using GitHub Copilot modernization. This step-by-step guide covers assessment and the three-stage workflow: assessment, planning, and execution." +title: How to upgrade a .NET app with GitHub Copilot upgrade +description: "Learn how to upgrade your .NET applications to newer versions using GitHub Copilot upgrade. This step-by-step guide covers assessment and the three-stage workflow: assessment, planning, and execution." ms.topic: how-to ms.date: 07/07/2026 ai-usage: ai-assisted -#customer intent: As a developer, I want to upgrade my .NET app using GitHub Copilot modernization so that I can modernize my codebase efficiently with AI assistance through a structured three-stage process. +#customer intent: As a developer, I want to upgrade my .NET app using GitHub Copilot upgrade so that I can modernize my codebase efficiently with AI assistance through a structured three-stage process. --- -# Upgrade a .NET app with GitHub Copilot modernization +# Upgrade a .NET app with GitHub Copilot upgrade -GitHub Copilot modernization is an AI-powered agent that upgrades .NET projects to newer versions and migrates applications to Azure. This article walks you through upgrading your .NET applications with a structured three-stage workflow: assessment, planning, and execution. +GitHub Copilot upgrade is an AI-powered agent that upgrades .NET projects to newer versions. This article walks you through upgrading your .NET applications with a structured three-stage workflow: assessment, planning, and execution. -The modernization agent analyzes your projects and dependencies, creates detailed upgrade documentation at each stage, and helps with code fixes throughout the process. The agent supports upgrading from older .NET versions to the latest, including upgrades from .NET Framework to modern .NET. +The agent analyzes your projects and dependencies, creates detailed upgrade documentation at each stage, and helps with code fixes throughout the process. The agent supports upgrading from older .NET versions to the latest, including upgrades from .NET Framework to modern .NET. ## Prerequisites -Set up GitHub Copilot modernization in your development environment before starting an upgrade. For installation steps, see [Install GitHub Copilot modernization](install.md). +Set up GitHub Copilot upgrade in your development environment before starting an upgrade. For installation steps, see [Install GitHub Copilot upgrade](install.md). ## Initiate the upgrade @@ -239,9 +239,9 @@ To verify the upgrade: ## Related content -- [What is GitHub Copilot modernization?](overview.md) -- [Install GitHub Copilot modernization](install.md) +- [What is GitHub Copilot upgrade?](overview.md) +- [Install GitHub Copilot upgrade](install.md) - [Core concepts](concepts.md) - [Best practices](best-practices.md) -- [Troubleshoot GitHub Copilot modernization](troubleshooting.md) -- [GitHub Copilot modernization FAQ](faq.yml) +- [Troubleshoot GitHub Copilot upgrade](troubleshooting.md) +- [GitHub Copilot upgrade FAQ](faq.yml) diff --git a/docs/core/porting/github-copilot-app-modernization/includes/how-to-initiate.md b/docs/core/porting/github-copilot-upgrade/includes/how-to-initiate.md similarity index 100% rename from docs/core/porting/github-copilot-app-modernization/includes/how-to-initiate.md rename to docs/core/porting/github-copilot-upgrade/includes/how-to-initiate.md diff --git a/docs/core/porting/github-copilot-app-modernization/includes/supported-upgrade-paths.md b/docs/core/porting/github-copilot-upgrade/includes/supported-upgrade-paths.md similarity index 100% rename from docs/core/porting/github-copilot-app-modernization/includes/supported-upgrade-paths.md rename to docs/core/porting/github-copilot-upgrade/includes/supported-upgrade-paths.md diff --git a/docs/core/porting/github-copilot-app-modernization/index.yml b/docs/core/porting/github-copilot-upgrade/index.yml similarity index 55% rename from docs/core/porting/github-copilot-app-modernization/index.yml rename to docs/core/porting/github-copilot-upgrade/index.yml index c109ff1721a71..9b76b3192fce2 100644 --- a/docs/core/porting/github-copilot-app-modernization/index.yml +++ b/docs/core/porting/github-copilot-upgrade/index.yml @@ -1,11 +1,11 @@ ### YamlMime:Landing -title: Use GitHub Copilot modernization to upgrade and migrate .NET apps -summary: Learn about updating and migrating .NET apps with GitHub Copilot modernization. +title: Use GitHub Copilot upgrade to upgrade .NET apps +summary: Learn about upgrading .NET apps with GitHub Copilot upgrade. metadata: - title: Use GitHub Copilot modernization to upgrade and migrate .NET apps - description: Learn about updating and migrating .NET apps with GitHub Copilot modernization. + title: Use GitHub Copilot upgrade to upgrade .NET apps + description: Learn about upgrading .NET apps with GitHub Copilot upgrade. ms.topic: landing-page ms.date: 03/04/2026 @@ -44,18 +44,8 @@ landingContent: linkLists: - linkListType: overview links: - - text: Migrate .NET apps to Azure - url: ../../../azure/migration/appmod/overview.md?toc=/dotnet/navigate/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json - - text: Azure migration quickstart - url: ../../../azure/migration/appmod/quickstart.md?toc=/dotnet/navigate/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json - - linkListType: sample - links: - - text: Migration sample - url: ../../../azure/migration/appmod/sample.md?toc=/dotnet/navigate/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json - - linkListType: concept - links: - - text: Azure migration FAQ - url: ../../../azure/migration/appmod/faq.md?toc=/dotnet/navigate/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json + - text: GitHub Copilot modernization overview + url: ../../../azure/migration/appmod/overview.md - title: Get help and community linkLists: diff --git a/docs/core/porting/github-copilot-app-modernization/install.md b/docs/core/porting/github-copilot-upgrade/install.md similarity index 78% rename from docs/core/porting/github-copilot-app-modernization/install.md rename to docs/core/porting/github-copilot-upgrade/install.md index d877fd6b8490f..844da3456bccc 100644 --- a/docs/core/porting/github-copilot-app-modernization/install.md +++ b/docs/core/porting/github-copilot-upgrade/install.md @@ -1,18 +1,18 @@ --- -title: Install GitHub Copilot modernization -description: "Learn how to install and set up GitHub Copilot modernization across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com." +title: Install GitHub Copilot upgrade +description: "Learn how to install and set up GitHub Copilot upgrade across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com." ms.topic: install-set-up-deploy ms.date: 07/07/2026 ai-usage: ai-assisted zone_pivot_groups: copilot-modernization-install -#customer intent: As a developer, I want to install GitHub Copilot modernization so that I can upgrade my .NET applications. +#customer intent: As a developer, I want to install GitHub Copilot upgrade so that I can upgrade my .NET applications. --- -# Install GitHub Copilot modernization +# Install GitHub Copilot upgrade -GitHub Copilot modernization works across multiple development environments. Choose your preferred environment to install and set up GitHub Copilot modernization. +GitHub Copilot upgrade works across multiple development environments. Choose your preferred environment to install and set up GitHub Copilot upgrade. ::: zone pivot="visualstudio" @@ -29,7 +29,7 @@ Before you install, make sure you have: ## Install -Visual Studio includes GitHub Copilot modernization through the **GitHub Copilot app modernization** optional component, so you don't need to install it separately. Enable the **GitHub Copilot** and **GitHub Copilot app modernization** optional components in the **.NET desktop development** workload through the Visual Studio Installer. +Visual Studio includes GitHub Copilot upgrade through the **GitHub Copilot app modernization** optional component, so you don't need to install it separately. Enable the **GitHub Copilot** and **GitHub Copilot app modernization** optional components in the **.NET desktop development** workload through the Visual Studio Installer. ## Verify the installation @@ -133,7 +133,7 @@ Select the **Default agent** picker and find the **Upgrade** entry. ## Related content -- [What is GitHub Copilot modernization?](overview.md) -- [Upgrade a .NET app with GitHub Copilot modernization](how-to-upgrade-with-github-copilot.md) +- [What is GitHub Copilot upgrade?](overview.md) +- [Upgrade a .NET app with GitHub Copilot upgrade](how-to-upgrade-with-github-copilot.md) - [Core concepts](concepts.md) -- [GitHub Copilot modernization FAQ](faq.yml) +- [GitHub Copilot upgrade FAQ](faq.yml) diff --git a/docs/core/porting/github-copilot-upgrade/overview.md b/docs/core/porting/github-copilot-upgrade/overview.md new file mode 100644 index 0000000000000..843701a42ca6e --- /dev/null +++ b/docs/core/porting/github-copilot-upgrade/overview.md @@ -0,0 +1,164 @@ +--- +title: GitHub Copilot upgrade overview +description: "Learn about GitHub Copilot upgrade, a Copilot agent available across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com that upgrades .NET projects to newer versions of .NET." +titleSuffix: "" +ms.topic: overview +ms.date: 07/07/2026 +ai-usage: ai-assisted + +#customer intent: As a developer, I want to learn about what GitHub Copilot upgrade is, so that I understand its capabilities and how I can take advantage of it. + +--- + +# What is GitHub Copilot upgrade? + +GitHub Copilot upgrade is a GitHub Copilot agent that helps you upgrade projects to newer versions of .NET quickly and confidently. It guides you through assessment, solution recommendations, code fixes, and validation across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com. + +Use this agent to: + +- Upgrade to a newer version of .NET. +- Modernize your .NET app, especially when upgrading from .NET Framework. +- Assess your application's code, configuration, and dependencies. +- Validate that your app builds and tests successfully. + +## Scenarios + +The agent provides multiple end-to-end modernization workflows called _scenarios_. Each scenario is a managed workflow that guides you through a specific type of upgrade or migration: + +| Scenario | Description | Example prompt | +|---|---|---| +| **.NET version upgrade** | Upgrades from older .NET versions to .NET 8, 9, 10, or later. | _"Upgrade my solution to .NET 10"_ | +| **SDK-style conversion** | Converts legacy project format to SDK-style. | _"Convert to SDK-style"_ | +| **Newtonsoft.Json upgrade** | Replaces Newtonsoft.Json with System.Text.Json. | _"Upgrade from Newtonsoft.Json"_ | +| **SqlClient upgrade** | Upgrades from System.Data.SqlClient to Microsoft.Data.SqlClient. | _"Update SqlClient"_ | +| **Azure Functions upgrade** | Upgrades Azure Functions from in-process to isolated worker model. | _"Upgrade my Azure Functions"_ | +| **Semantic Kernel to Agents** | Upgrades Semantic Kernel Agents to Microsoft Agent Framework. | _"Upgrade my SK agents"_ | +| **Aspire integration** | Adds [Aspire](https://aspire.dev) support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | +| **Aspire version upgrade** | Upgrades existing Aspire applications to newer versions. | _"Upgrade my Aspire version"_ | +| **WebForms-to-Blazor upgrade** | Upgrades ASP.NET Web Forms applications to Blazor. | _"Migrate my Web Forms app to Blazor"_ | + +For a full reference of all scenarios and 30+ built-in upgrade skills, see [Scenarios and skills reference](scenarios-and-skills.md). + +## Provide feedback + +Microsoft values your feedback and uses it to improve the agent. Leave feedback using either of these options: + +- In Visual Studio, use the [Suggest a feature](/visualstudio/ide/suggest-a-feature) and [Report a problem](/visualstudio/ide/report-a-problem) options. + +- File an issue at the [Upgrade Agent GitHub repository](https://github.com/microsoft/upgrade-agent-plugins). + +## Prerequisites + +Set up GitHub Copilot upgrade in your development environment before using the agent. For installation steps, see [Install GitHub Copilot upgrade](install.md). + +## Upgrade .NET projects + +The upgrade agent supports upgrading C# and Visual Basic projects of the following types: + +- ASP.NET Core (and related technologies such as MVC, Razor Pages, and Web API) +- ASP.NET Web Forms +- Blazor +- Azure Functions +- Windows Presentation Foundation (WPF) +- Windows Forms +- WinUI +- .NET MAUI and Xamarin +- Class libraries +- Console apps +- Test projects (MSTest, NUnit, and xUnit) + +To start an upgrade, see [Upgrade a .NET app with GitHub Copilot upgrade](how-to-upgrade-with-github-copilot.md). + +### Supported upgrade paths + +The agent supports the following upgrade paths: + +[!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] + +## Migrate .NET projects to Azure + +To migrate your .NET applications to Azure, use the [GitHub Copilot modernization agent](../../../azure/migration/appmod/overview.md). The modernization agent handles Azure-specific scenarios such as database migration, storage, identity, messaging, and deployment. + +## How it works + +To start an upgrade or migration process, see: + +[!INCLUDE[github-copilot-how-to-initiate](./includes/how-to-initiate.md)] + +When you ask the upgrade agent to upgrade your app, Copilot first prompts you to create a new branch if you're working in a Git repository. Then Copilot assesses your project and runs a three-stage workflow. Each stage produces Markdown files under `.github/upgrades/{scenarioId}` in your repository so you can review what comes next before you continue. If `.github/upgrades/{scenarioId}` already exists from a prior attempt, Copilot asks whether to continue or start fresh. + +Copilot starts by examining your project structure, dependencies, and code patterns to build a comprehensive assessment. The `assessment.md` file lists breaking changes, API compatibility problems, deprecated patterns, and the upgrade scope. + +After the assessment, Copilot runs the following three stages: + +1. **Assessment:** Copilot examines your project structure, dependencies, and code patterns, then presents strategy decisions for your review, such as the upgrade strategy (bottom-up, top-down, or all-at-once), project upgrade approach, technology modernization options, and compatibility handling. Copilot saves confirmed decisions to `upgrade-options.md`. + +1. **Planning:** Copilot converts the assessment and your confirmed options into a detailed specification. The `plan.md` file documents upgrade strategies, refactoring approaches, dependency paths, and risk mitigations. + +1. **Execution:** Copilot breaks the plan into sequential, concrete tasks with validation criteria in `tasks.md`. Each task describes a single change and how Copilot confirms it succeeded. + +Edit any of the Markdown files in `.github/upgrades/{scenarioId}` to adjust upgrade steps or add context before you move forward. + +### Upgrade strategies + +During the assessment stage, the agent evaluates your solution and recommends one of these strategies: + +| Strategy | Best for | Description | +|---|---|---| +| **Bottom-up** | Large solutions with deep dependency graphs | Upgrades leaf projects first, then works upward. | +| **Top-down** | Quick feedback on the main application | Upgrades the application project first, then fixes dependencies. | +| **All-at-once** | Small, simple solutions | Upgrades all projects in one pass. | + +### Flow modes + +The agent supports two flow modes that control how much it pauses for your input: + +- **Automatic:** The agent works through all stages without pausing, stopping only at genuine blockers. Best for experienced users and straightforward upgrades. +- **Guided:** The agent pauses at each stage boundary so you can review the assessment, plan, and tasks before proceeding. Best for first-time users and complex solutions. + +Switch between modes at any time by saying _"pause"_ (to enter guided mode) or _"continue"_ (to enter automatic mode). + +### State management + +The agent stores all upgrade state in `.github/upgrades/{scenarioId}/`. The folder contains: + +| File | Purpose | +|---|---| +| `assessment.md` | Analysis of your solution | +| `upgrade-options.md` | Confirmed upgrade decisions | +| `plan.md` | Ordered task plan | +| `tasks.md` | Live progress dashboard | +| `scenario-instructions.md` | Agent's persistent memory, including preferences, decisions, and custom instructions | +| `tasks/{taskId}/task.md` | Per-task scope and context | +| `tasks/{taskId}/progress-details.md` | Per-task execution notes and results | + +Because all state lives in this folder, you can close your IDE, switch between sessions, or even switch between development environments (for example, start in VS Code and continue in Visual Studio). The agent picks up where it left off. + +> [!TIP] +> Commit the `.github/upgrades/` folder to your branch. The committed state serves as a backup and lets team members view upgrade progress. + +### Perform the upgrade + +After each stage completes, review and modify the generated files as needed, and then tell Copilot to continue to the next stage. + +When you reach the **Execution** stage, tell Copilot to start the upgrade. If Copilot runs into a problem, it tries to identify the cause and apply a fix. If Copilot can't correct the problem, it asks for your help. When you intervene, Copilot learns from the changes you make and tries to automatically apply them if the problem comes up again. + +### Upgrade results + +As Copilot runs each task, it updates the `tasks.md` file in `.github/upgrades/{scenarioId}` with the status of every step. Monitor progress by reviewing this file. Copilot creates a Git commit for every portion of the process, so you can roll back changes or review what changed. + +When the upgrade finishes, Copilot displays next steps in the chat response. + +## Telemetry + +The tool collects data about project types, intent to upgrade, and upgrade duration. The development environment collects and aggregates the data and doesn't contain any user-identifiable information. For more information about Microsoft's privacy policy, see [Visual Studio Customer Experience Improvement Program](/visualstudio/ide/visual-studio-experience-improvement-program?view=visualstudio&preserve-view=true). + +## Related content + +- [Install GitHub Copilot upgrade](install.md) +- [Upgrade a .NET app with GitHub Copilot upgrade](how-to-upgrade-with-github-copilot.md) +- [Core concepts](concepts.md) +- [Scenarios and skills reference](scenarios-and-skills.md) +- [Best practices](best-practices.md) +- [Troubleshoot GitHub Copilot upgrade](troubleshooting.md) +- [GitHub Copilot upgrade FAQ](faq.yml) diff --git a/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md b/docs/core/porting/github-copilot-upgrade/scenarios-and-skills.md similarity index 96% rename from docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md rename to docs/core/porting/github-copilot-upgrade/scenarios-and-skills.md index 131537a9215e6..326642c68cab8 100644 --- a/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md +++ b/docs/core/porting/github-copilot-upgrade/scenarios-and-skills.md @@ -1,17 +1,17 @@ --- -title: GitHub Copilot modernization scenarios and skills -description: "Complete reference of all scenarios and built-in upgrade skills available in GitHub Copilot modernization for .NET, organized by domain." +title: GitHub Copilot upgrade scenarios and skills +description: "Complete reference of all scenarios and built-in upgrade skills available in GitHub Copilot upgrade for .NET, organized by domain." ms.topic: reference ms.date: 07/07/2026 ai-usage: ai-assisted -#customer intent: As a developer, I want to see all the scenarios and skills that GitHub Copilot modernization supports so that I can understand which upgrade tasks the agent can handle for me. +#customer intent: As a developer, I want to see all the scenarios and skills that GitHub Copilot upgrade supports so that I can understand which upgrade tasks the agent can handle for me. --- # Scenarios and skills reference -GitHub Copilot modernization for .NET helps you modernize through _scenarios_ and _skills_: +GitHub Copilot upgrade for .NET helps you upgrade and modernize through _scenarios_ and _skills_: - **Scenarios** are end-to-end managed workflows for major upgrade goals, such as upgrading from .NET Framework to .NET 10. Scenarios coordinate the full lifecycle: assessment, planning, and task-by-task execution. - **Skills** are focused capabilities for specific upgrade tasks, such as converting EF6 to EF Core or replacing WCF with CoreWCF. Skills activate automatically when the agent encounters relevant code during an upgrade. @@ -201,7 +201,7 @@ For more information about creating custom skills, see [Apply custom upgrade ins ## Related content -- [What is GitHub Copilot modernization?](overview.md) +- [What is GitHub Copilot upgrade?](overview.md) - [Core concepts](concepts.md) -- [Upgrade a .NET app with GitHub Copilot modernization](how-to-upgrade-with-github-copilot.md) +- [Upgrade a .NET app with GitHub Copilot upgrade](how-to-upgrade-with-github-copilot.md) - [Apply custom upgrade instructions](how-to-custom-upgrade-instructions.md) diff --git a/docs/core/porting/github-copilot-app-modernization/toc.yml b/docs/core/porting/github-copilot-upgrade/toc.yml similarity index 88% rename from docs/core/porting/github-copilot-app-modernization/toc.yml rename to docs/core/porting/github-copilot-upgrade/toc.yml index 8260f2a46e0f2..1ee53aa4808d2 100644 --- a/docs/core/porting/github-copilot-app-modernization/toc.yml +++ b/docs/core/porting/github-copilot-upgrade/toc.yml @@ -1,5 +1,5 @@ items: - - name: GitHub Copilot modernization for .NET + - name: GitHub Copilot upgrade for .NET href: index.yml - name: Overview href: overview.md @@ -30,4 +30,4 @@ items: href: troubleshooting.md - name: Migrate .NET apps to Azure - href: ../../../azure/migration/appmod/predefined-tasks.md + href: ../../../azure/migration/appmod/overview.md diff --git a/docs/core/porting/github-copilot-app-modernization/troubleshooting.md b/docs/core/porting/github-copilot-upgrade/troubleshooting.md similarity index 92% rename from docs/core/porting/github-copilot-app-modernization/troubleshooting.md rename to docs/core/porting/github-copilot-upgrade/troubleshooting.md index b6cc517146375..c246131dd50b6 100644 --- a/docs/core/porting/github-copilot-app-modernization/troubleshooting.md +++ b/docs/core/porting/github-copilot-upgrade/troubleshooting.md @@ -1,17 +1,17 @@ --- -title: Troubleshoot GitHub Copilot modernization -description: "Find solutions to common problems when you use GitHub Copilot modernization for .NET, including workflow, build, Git, performance, and customization issues." +title: Troubleshoot GitHub Copilot upgrade +description: "Find solutions to common problems when you use GitHub Copilot upgrade for .NET, including workflow, build, Git, performance, and customization issues." ms.topic: troubleshooting-general ms.date: 07/07/2026 ai-usage: ai-assisted -#customer intent: As a developer, I want to troubleshoot issues with GitHub Copilot modernization so that I can resolve problems and continue my .NET upgrade. +#customer intent: As a developer, I want to troubleshoot issues with GitHub Copilot upgrade so that I can resolve problems and continue my .NET upgrade. --- -# Troubleshoot GitHub Copilot modernization +# Troubleshoot GitHub Copilot upgrade -This article covers common issues you might encounter when you use GitHub Copilot modernization for .NET, organized by category. Each entry follows a problem, cause, and solution format so you can find and resolve issues quickly. +This article covers common issues you might encounter when you use GitHub Copilot upgrade for .NET, organized by category. Each entry follows a problem, cause, and solution format so you can find and resolve issues quickly. ## Workflow issues @@ -186,11 +186,11 @@ When something isn't working as expected: 1. **Ask the agent:** Ask _"What went wrong with the last task?"_ The agent can often explain what happened and suggest next steps. 1. **Review the task progress:** Open `tasks.md` in `.github/upgrades/{scenarioId}/` to find the last task ID, and then open `tasks/{taskId}/progress-details.md`. The progress details show what the agent did, including any errors it encountered. -1. **File an issue:** If you've found a bug or the agent consistently fails at something, file an issue at the [@modernize-dotnet GitHub repository](https://github.com/dotnet/modernize-dotnet). +1. **File an issue:** If you've found a bug or the agent consistently fails at something, file an issue at the [upgrade-agent-plugins GitHub repository](https://github.com/microsoft/upgrade-agent-plugins). ## Related content -- [What is GitHub Copilot modernization?](overview.md) +- [What is GitHub Copilot upgrade?](overview.md) - [Best practices](best-practices.md) - [Core concepts](concepts.md) -- [GitHub Copilot modernization FAQ](faq.yml) +- [GitHub Copilot upgrade FAQ](faq.yml) diff --git a/docs/core/porting/github-copilot-app-modernization/working-with-agent.md b/docs/core/porting/github-copilot-upgrade/working-with-agent.md similarity index 91% rename from docs/core/porting/github-copilot-app-modernization/working-with-agent.md rename to docs/core/porting/github-copilot-upgrade/working-with-agent.md index 3bbb4dd949e2b..dc51a4b97a19d 100644 --- a/docs/core/porting/github-copilot-app-modernization/working-with-agent.md +++ b/docs/core/porting/github-copilot-upgrade/working-with-agent.md @@ -1,19 +1,19 @@ --- -title: Work with GitHub Copilot modernization -description: "Learn how to collaborate effectively with GitHub Copilot modernization, including communication patterns, teaching preferences, mid-session corrections, and multi-session workflows." +title: Work with GitHub Copilot upgrade +description: "Learn how to collaborate effectively with GitHub Copilot upgrade, including communication patterns, teaching preferences, mid-session corrections, and multi-session workflows." ms.topic: concept-article ms.date: 07/07/2026 ai-usage: ai-assisted -#customer intent: As a developer, I want to learn how to work effectively with the GitHub Copilot modernization agent so that I can get the best results from my .NET upgrade. +#customer intent: As a developer, I want to learn how to work effectively with the GitHub Copilot upgrade agent so that I can get the best results from my .NET upgrade. --- -# Work with GitHub Copilot modernization +# Work with GitHub Copilot upgrade -This article covers how to communicate with the GitHub Copilot modernization agent, teach it your preferences, correct mistakes, review its work, and manage upgrades across multiple sessions. +This article covers how to communicate with the GitHub Copilot upgrade agent, teach it your preferences, correct mistakes, review its work, and manage upgrades across multiple sessions. -GitHub Copilot modernization is an interactive collaborator that asks questions, proposes strategies, adapts to your feedback, and learns from your preferences over time. To get the best results, give the agent context. The more it knows about your goals, constraints, and preferences, the better it performs. +GitHub Copilot upgrade is an interactive collaborator that asks questions, proposes strategies, adapts to your feedback, and learns from your preferences over time. To get the best results, give the agent context. The more it knows about your goals, constraints, and preferences, the better it performs. ```text ❌ Vague — the agent has to guess @@ -292,8 +292,8 @@ Positive feedback helps just as much as corrections and confirms the agent is on ## Related content -- [What is GitHub Copilot modernization?](overview.md) +- [What is GitHub Copilot upgrade?](overview.md) - [Core concepts](concepts.md) - [Best practices](best-practices.md) -- [Customize GitHub Copilot modernization](customization.md) -- [Troubleshoot GitHub Copilot modernization](troubleshooting.md) +- [Customize GitHub Copilot upgrade](customization.md) +- [Troubleshoot GitHub Copilot upgrade](troubleshooting.md) diff --git a/docs/core/porting/includes/github-copilot-suggestion.md b/docs/core/porting/includes/github-copilot-suggestion.md index 2f09cb17abfe1..63dbb16606640 100644 --- a/docs/core/porting/includes/github-copilot-suggestion.md +++ b/docs/core/porting/includes/github-copilot-suggestion.md @@ -6,4 +6,4 @@ 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. +> .NET Upgrade Assistant is officially deprecated. Use the [GitHub Copilot modernization chat agent](../github-copilot-upgrade/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. diff --git a/docs/core/porting/index.md b/docs/core/porting/index.md index 33d9f344cb9e9..d0eed19026a52 100644 --- a/docs/core/porting/index.md +++ b/docs/core/porting/index.md @@ -60,7 +60,7 @@ Most upgrades fall into one of the following categories. Start with the guidance ## GitHub Copilot app modernization (recommended) -The [GitHub Copilot app modernization agent](github-copilot-app-modernization/overview.md) provides an AI-assisted, end-to-end experience that speeds porting and modernization work. The agent analyzes your project and writes a plan to complete your desired upgrade. You can adjust and iterate on the plan, then perform the upgrades. With this agent, you can: +The [GitHub Copilot app modernization agent](github-copilot-upgrade/overview.md) provides an AI-assisted, end-to-end experience that speeds porting and modernization work. The agent analyzes your project and writes a plan to complete your desired upgrade. You can adjust and iterate on the plan, then perform the upgrades. With this agent, you can: - Upgrade projects to a newer .NET version. - Assess your application's code, configuration, and dependencies. @@ -70,7 +70,7 @@ The [GitHub Copilot app modernization agent](github-copilot-app-modernization/ov - Fix issues and apply cloud-migration best practices. - Validate that your app builds and that tests pass. -Use the agent when you want a guided, AI-powered path to assess, remediate, and modernize codebases—particularly for projects that have many dependencies, rely on Windows-specific APIs, or that you plan to containerize or migrate to the cloud. For more information, see [What is GitHub Copilot app modernization](github-copilot-app-modernization/overview.md). +Use the agent when you want a guided, AI-powered path to assess, remediate, and modernize codebases—particularly for projects that have many dependencies, rely on Windows-specific APIs, or that you plan to containerize or migrate to the cloud. For more information, see [What is GitHub Copilot app modernization](github-copilot-upgrade/overview.md). ### .NET Upgrade Assistant (deprecated) @@ -79,6 +79,6 @@ Use the agent when you want a guided, AI-powered path to assess, remediate, and ## Next steps - [Overview of porting from .NET Framework to .NET](framework-overview.md) -- [What is GitHub Copilot app modernization](github-copilot-app-modernization/overview.md) +- [What is GitHub Copilot app modernization](github-copilot-upgrade/overview.md) - [Modernize after upgrading to .NET from .NET Framework](modernize.md) - [.NET releases, patches, and support](../releases-and-support.md) diff --git a/docs/core/porting/modernize.md b/docs/core/porting/modernize.md index 43d46590b5684..51eb161981f41 100644 --- a/docs/core/porting/modernize.md +++ b/docs/core/porting/modernize.md @@ -10,7 +10,7 @@ ms.custom: sfi-ropc-nochange # Modernize after upgrading to .NET from .NET Framework -In this article, you'll learn about different ways you can modernize your app after it's been upgraded from .NET Framework to .NET. Use the [GitHub Copilot modernization](github-copilot-app-modernization/overview.md) chat agent to upgrade your app to .NET. +In this article, you'll learn about different ways you can modernize your app after it's been upgraded from .NET Framework to .NET. Use the [GitHub Copilot modernization](github-copilot-upgrade/overview.md) chat agent to upgrade your app to .NET. ## Missing APIs diff --git a/docs/core/porting/porting-approaches.md b/docs/core/porting/porting-approaches.md index 1fd88719b4ca2..ea5698133cc51 100644 --- a/docs/core/porting/porting-approaches.md +++ b/docs/core/porting/porting-approaches.md @@ -98,5 +98,5 @@ If you start with the base of your library and move outward from the base and te ## Next steps -- [What is GitHub Copilot modernization](github-copilot-app-modernization/overview.md) +- [What is GitHub Copilot modernization](github-copilot-upgrade/overview.md) - [Organize your project to support both .NET Framework and .NET Core](project-structure.md) diff --git a/docs/core/porting/third-party-deps.md b/docs/core/porting/third-party-deps.md index f428a09ddbff8..2c341781f2d6f 100644 --- a/docs/core/porting/third-party-deps.md +++ b/docs/core/porting/third-party-deps.md @@ -95,7 +95,7 @@ The .NET Team would like to know which libraries are the most important to suppo ## Analyze non-NuGet dependencies -You might have a dependency that isn't a NuGet package, such as a DLL in the file system. You can determine the portability of that dependency with the [GitHub Copilot modernization agent](github-copilot-app-modernization/overview.md). +You might have a dependency that isn't a NuGet package, such as a DLL in the file system. You can determine the portability of that dependency with the [GitHub Copilot modernization agent](github-copilot-upgrade/overview.md). ## Next steps diff --git a/docs/core/tools/sdk-errors/netsdk1138.md b/docs/core/tools/sdk-errors/netsdk1138.md index cf1ba6ae389a6..ad42ec7c64eb9 100644 --- a/docs/core/tools/sdk-errors/netsdk1138.md +++ b/docs/core/tools/sdk-errors/netsdk1138.md @@ -17,7 +17,7 @@ Out-of-support versions include 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5, 6, and 7. To resolve this error, change your project to target a supported version of .NET. > [!TIP] -> You can use [GitHub Copilot modernization](../../porting/github-copilot-app-modernization/overview.md) to assess, plan, and upgrade your project to a supported version of .NET. +> You can use [GitHub Copilot modernization](../../porting/github-copilot-upgrade/overview.md) to assess, plan, and upgrade your project to a supported version of .NET. If you want to suppress the message without targeting a later framework, set the MSBuild property `CheckEolTargetFramework` to `false`. You can set it in the project file or by passing `/p:CheckEolTargetFramework=false` to a .NET CLI command, such as `dotnet build`. Here's an example project file: diff --git a/docs/navigate/migration-guide/index.yml b/docs/navigate/migration-guide/index.yml index fdfe66181b1a3..448c4ddc8556a 100644 --- a/docs/navigate/migration-guide/index.yml +++ b/docs/navigate/migration-guide/index.yml @@ -18,7 +18,7 @@ landingContent: - text: Upgrade apps to the latest version of .NET url: ../../core/porting/index.md - text: Use GitHub Copilot to assist in upgrading - url: ../../core/porting/github-copilot-app-modernization/overview.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + url: ../../core/porting/github-copilot-upgrade/overview.md - text: Plan your .NET Framework upgrade url: ../../core/porting/framework-overview.md - linkListType: concept @@ -34,30 +34,30 @@ landingContent: - linkListType: overview links: - text: GitHub Copilot modernization overview - url: ../../core/porting/github-copilot-app-modernization/overview.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + url: ../../core/porting/github-copilot-upgrade/overview.md - text: GitHub Copilot modernization FAQ - url: ../../core/porting/github-copilot-app-modernization/faq.yml?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + url: ../../core/porting/github-copilot-upgrade/faq.yml - linkListType: concept links: - text: Using Copilot to speed up porting and modernization - url: ../../core/porting/github-copilot-app-modernization/overview.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json#how-it-works + url: ../../core/porting/github-copilot-upgrade/overview.md#how-it-works - title: Migrate .NET apps to Azure linkLists: - linkListType: overview links: - text: Migrate .NET apps to Azure (app modernization) - url: ../../azure/migration/appmod/overview.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + url: ../../azure/migration/appmod/overview.md - text: Azure migration quickstart - url: ../../azure/migration/appmod/quickstart.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + url: ../../azure/migration/appmod/quickstart.md - linkListType: sample links: - text: Migration sample - url: ../../azure/migration/appmod/sample.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + url: ../../azure/migration/appmod/sample.md - linkListType: concept links: - text: Azure migration FAQ - url: ../../core/porting/github-copilot-app-modernization/faq.yml?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + url: ../../core/porting/github-copilot-upgrade/faq.yml - title: Get help and community linkLists: diff --git a/docs/navigate/migration-guide/toc.yml b/docs/navigate/migration-guide/toc.yml index ff97484f8d9e4..14272ee13dc94 100644 --- a/docs/navigate/migration-guide/toc.yml +++ b/docs/navigate/migration-guide/toc.yml @@ -7,40 +7,40 @@ items: expanded: true items: - name: Overview - href: ../../core/porting/github-copilot-app-modernization/overview.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/overview.md displayName: copilot, upgrade - name: Install - href: ../../core/porting/github-copilot-app-modernization/install.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/install.md displayName: copilot, upgrade - name: Core concepts - href: ../../core/porting/github-copilot-app-modernization/concepts.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/concepts.md displayName: copilot, upgrade - name: Working with the agent - href: ../../core/porting/github-copilot-app-modernization/working-with-agent.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/working-with-agent.md displayName: copilot, upgrade - name: Scenarios and skills reference - href: ../../core/porting/github-copilot-app-modernization/scenarios-and-skills.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/scenarios-and-skills.md displayName: copilot, upgrade - name: Customization - href: ../../core/porting/github-copilot-app-modernization/customization.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/customization.md displayName: copilot, upgrade - name: FAQ - href: ../../core/porting/github-copilot-app-modernization/faq.yml?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/faq.yml displayName: copilot, upgrade - name: Upgrade .NET apps expanded: false items: - name: How to upgrade with GitHub Copilot - href: ../../core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot.md displayName: copilot, upgrade - name: How to apply custom upgrade instructions - href: ../../core/porting/github-copilot-app-modernization/how-to-custom-upgrade-instructions.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/how-to-custom-upgrade-instructions.md displayName: copilot, upgrade - name: Best practices - href: ../../core/porting/github-copilot-app-modernization/best-practices.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/best-practices.md displayName: copilot, upgrade - name: Troubleshooting - href: ../../core/porting/github-copilot-app-modernization/troubleshooting.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/troubleshooting.md displayName: copilot, upgrade - name: Migrate .NET apps to Azure href: ../../azure/migration/appmod/predefined-tasks.md @@ -50,7 +50,7 @@ items: - name: Overview href: ../../core/porting/framework-overview.md - name: Upgrade with GitHub Copilot - href: ../../core/porting/github-copilot-app-modernization/overview.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: ../../core/porting/github-copilot-upgrade/overview.md displayName: copilot, upgrade, modernization - name: General information items: @@ -98,9 +98,9 @@ items: - name: Application porting guides items: - name: Windows Forms - href: /dotnet/desktop/winforms/migration/?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: /dotnet/desktop/winforms/migration/ - name: Windows Presentation Foundation - href: /dotnet/desktop/wpf/migration/?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: /dotnet/desktop/wpf/migration/ - name: C++/CLI projects href: ../../core/porting/cpp-cli.md - name: Post-upgrade