Updates

Author: adegeo

.openpublishing.redirection.azure.json

@@ -16,6 +16,14 @@
             "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/dotnet-quickstart-vs.md",
             "redirect_url": "/visualstudio/deployment/quickstart-deploy-aspnet-web-app"

docs/azure/migration/appmod/deploy.md

@@ -14,15 +14,7 @@ In this quickstart, you learn how to deploy your project to Azure with GitHub Co
 
 ## Prerequisites
 
-- Windows operating system
-- [Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/)
-- [.NET desktop development workload](/visualstudio/install/modify-visual-studio?view=vs-2022&preserve-view=true#change-workloads-or-individual-components) with these optional components enabled:
-  - GitHub Copilot
-  - GitHub Copilot app modernization for .NET
-- GitHub account with Copilot access and a supported subscription plan:
-  - [Sign in to Visual Studio using a GitHub account](/visualstudio/ide/work-with-github-accounts) with [Copilot access](https://docs.github.com/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot).
-  - Supported subscription plans: Copilot Pro, Copilot Pro+, Copilot Business, or Copilot Enterprise.
-  - If you change subscriptions, restart Visual Studio.
+[!INCLUDE[github-copilot-app-mod-prereqs](../../../includes/github-copilot-app-mod-prereqs.md)]
 
 ## Deploy your project
 

docs/azure/migration/appmod/faq.md

@@ -27,9 +27,9 @@ items:
     - name: GitHub Copilot app modernization for .NET
       items:
         - name: Overview
-          href: ../core/porting/github-copilot-app-modernization-overview.md
+          href: ../core/porting/github-copilot-app-modernization-overview.md?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json
         - name: FAQ
-          href: ../core/porting/github-copilot-app-modernization-faq.yml
+          href: ../core/porting/github-copilot-app-modernization-faq.yml?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json
         - name: Predefined Tasks
           href: ./migration/appmod/predefined-tasks.md
         - name: Quickstart - Assess and migrate a .NET project

docs/azure/migration/appmod/overview.md

@@ -5,13 +5,13 @@ titleSuffix: ""
 author: adegeo
 ms.author: adegeo
 ms.topic: overview
-ms.date: 09/15/2025
+ms.date: 09/23/2025
 
-#customer intent: As a developer, I want to upgrade my project or migrate the project to Azure so that I can take advantage of the latest features.
+#customer intent: As a developer, I want to learn about what the GitHub Copilot app modernziation is, so that I understand its capabilities and how I can take advantage of it.
 
 ---
 
-# GitHub Copilot app modernization
+# What is GitHub Copilot app modernization?
 
 GitHub Copilot app modernization is a GitHub Copilot agent that helps upgrade projects to newer versions of .NET and migrate .NET applications to Azure quickly and confidently by guiding you through assessment, solution recommendations, code fixes, and validation - all within Visual Studio.
 
@@ -27,33 +27,24 @@ With this assistant, you can:
 - Fix issues and apply best practices for cloud migration.
 - Validate that your app builds and tests successfully.
 
+> [!IMPORTANT]
+> Starting with Visual Studio 2022 17.14.16, the GitHub Copilot Modernization agent is included with Visual Studio. If you're using an older version of Visual Studio 2022, upgrade to the latest release.
+
 ## Provide feedback
 
 Feedback is important to Microsoft and the efficiency of this agent. Use the [Suggest a feature](/visualstudio/ide/suggest-a-feature) and [Report a problem](/visualstudio/ide/report-a-problem) features of Visual Studio to provide feedback.
 
 ## Prerequisites
 
-- Windows Operating System
-- [Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/). (To be released)
-- [.NET desktop development workload](/visualstudio/install/modify-visual-studio?view=vs-2022&preserve-view=true#change-workloads-or-individual-components) with the following optional components enabled:
-
-  - GitHub Copilot
-  - GitHub Copilot app modernization for .NET
-
-- Copilot license and supported subscription plan:
-
-  [Sign in to Visual Studio using a GitHub account](/visualstudio/ide/work-with-github-accounts) with [Copilot access](https://docs.github.com/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot).
+The following items are required before you can use GitHub Copilot app modernization:
 
-  Supported subscription plans:
+[!INCLUDE[github-copilot-app-mod-prereqs](../../includes/github-copilot-app-mod-prereqs.md)]
 
-  - Copilot Pro
-  - Copilot Pro+
-  - Copilot Business
-  - Copilot Enterprise
+## How to start an upgrade or migration
 
-  (If you change subscriptions, you must restart Visual Studio.)
+To start an upgrade or migration, interact with GitHub Copilot, following these steps:
 
-- Code must be written in C#.
+[!INCLUDE[github-copilot-how-to-initiate](./includes/github-copilot-how-to-initiate.md)]
 
 ## Upgrade .NET projects