Add subfolder for GitHub Copilot app modernization (#48868)

gewarren · web-flow · commit a563450f9e0b · 2025-10-07T09:37:59.000-07:00
diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json
@@ -125,9 +125,10 @@
     ".openpublishing.redirection.fsharp.json",
     ".openpublishing.redirection.fundamentals.json",
     ".openpublishing.redirection.machine-learning.json",
+    ".openpublishing.redirection.navigate.json",
     ".openpublishing.redirection.orleans.json",
     ".openpublishing.redirection.standard.json",
     ".openpublishing.redirection.visual-basic.json"
   ],
   "need_generate_intellisense": false
-}
+}
diff --git a/.openpublishing.redirection.core.json b/.openpublishing.redirection.core.json
@@ -877,6 +877,18 @@
             "source_path_from_root": "/docs/core/packages.md",
             "redirect_url": "/dotnet/core/deploying"
         },
+        {
+            "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-faq.yml",
+            "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/faq"
+        },
+        {
+            "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-overview.md",
+            "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview"
+        },
+        {
+            "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"
+        },
         {
             "source_path_from_root": "/docs/core/porting/libraries.md",
             "redirect_url": "/dotnet/core/porting/"
diff --git a/.openpublishing.redirection.navigate.json b/.openpublishing.redirection.navigate.json
@@ -0,0 +1,8 @@
+{
+    "redirections": [
+        {
+            "source_path_from_root": "/docs/navigate/github-copilot-modernize/index.yml",
+            "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/index"
+        }
+    ]
+}
diff --git a/docs/azure/migration/appmod/containerization.md b/docs/azure/migration/appmod/containerization.md
@@ -22,7 +22,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-mod-prereqs](../../../includes/github-copilot-app-mod-prereqs.md)]
+[!INCLUDE[github-copilot-app-mod-prereqs](../../../core/porting/github-copilot-app-modernization/includes/prereqs.md)]
 
 ## Containerize your project
 
diff --git 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-mod-prereqs](../../../includes/github-copilot-app-mod-prereqs.md)]
+[!INCLUDE[github-copilot-app-mod-prereqs](../../../core/porting/github-copilot-app-modernization/includes/prereqs.md)]
 
 ## Deploy your project
 
diff --git a/docs/azure/migration/appmod/quickstart.md b/docs/azure/migration/appmod/quickstart.md
@@ -19,7 +19,7 @@ In this quickstart, you assess and migrate a .NET project by using GitHub Copilo
 
 ## Prerequisites
 
-[!INCLUDE[github-copilot-app-mod-prereqs](../../../includes/github-copilot-app-mod-prereqs.md)]
+[!INCLUDE[github-copilot-app-mod-prereqs](../../../core/porting/github-copilot-app-modernization/includes/prereqs.md)]
 
 ## Assess app readiness
 
@@ -108,4 +108,4 @@ You can choose one of the predefined options and send it in the chat:
 ## Next Steps
 
 - [Predefined Tasks](predefined-tasks.md)
-- [Frequently Asked Questions](../../../core/porting/github-copilot-app-modernization-faq.yml)
+- [Frequently Asked Questions](../../../core/porting/github-copilot-app-modernization/faq.yml)
diff --git a/docs/azure/toc.yml b/docs/azure/toc.yml
@@ -27,9 +27,9 @@ items:
     - name: GitHub Copilot app 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: ../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?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json
+          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
diff --git a/docs/core/install/upgrade.md b/docs/core/install/upgrade.md
@@ -39,7 +39,7 @@ Here's how to do it:
 - The same pattern applies for the `<TargetFrameworks>` property if it is being used.
 
 > [!TIP]
-> The [GitHub Copilot app modernization - upgrade](../porting/github-copilot-app-modernization-overview.md) capability can make these changes automatically.
+> The [GitHub Copilot app modernization - upgrade](../porting/github-copilot-app-modernization/overview.md) capability 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
@@ -125,7 +125,7 @@ Even if you use a tool to help port your application, you should review the [Con
 
 ### GitHub Copilot app modernization assistant
 
-[GitHub Copilot app modernization](github-copilot-app-modernization-overview.md) is a GitHub Copilot chat assistant 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 app modernization](github-copilot-app-modernization/overview.md) is a GitHub Copilot chat assistant 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 assistant 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 app 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 app 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 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 app modernization](github-copilot-app-modernization-overview.md)
+- [What is GitHub Copilot app modernization](github-copilot-app-modernization/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/faq.yml b/docs/core/porting/github-copilot-app-modernization/faq.yml
@@ -10,7 +10,7 @@ metadata:
 
 title: GitHub Copilot app modernization FAQ
 summary: |
-  GitHub Copilot app modernization is an interactive GitHub Copilot agent that adds powerful capabilities to Visual Studio. This article answers frequently asked questions. For more information about the modernization agent, see [What is GitHub Copilot app modernization](github-copilot-app-modernization-overview.md).
+  GitHub Copilot app modernization is an interactive GitHub Copilot agent that adds powerful capabilities to Visual Studio. This article answers frequently asked questions. For more information about the modernization agent, see [What is GitHub Copilot app modernization](overview.md).
 
   The tool requires one of the following GitHub Copilot subscriptions:
 
@@ -107,7 +107,7 @@ sections:
           - Logging
           - Security
 
-          For more information about these scenarios, see [Predefined tasks for migration](github-copilot-app-modernization-overview.md#predefined-tasks-for-migration).
+          For more information about these scenarios, see [Predefined tasks for migration](overview.md#predefined-tasks-for-migration).
 
       - question: Can I monitor assessment progress?
         answer: |
@@ -125,4 +125,4 @@ sections:
 additionalContent: |
     ## Related content
 
-    To learn more, see [What is GitHub Copilot app modernization?](github-copilot-app-modernization-overview.md).
+    To learn more, see [What is GitHub Copilot app modernization?](overview.md).
diff --git a/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md b/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md
@@ -21,13 +21,13 @@ The modernization agent analyzes your projects and dependencies, creates an upgr
 
 Before you begin, ensure you have the following requirements:
 
-[!INCLUDE[github-copilot-app-mod-prereqs](../../includes/github-copilot-app-mod-prereqs.md)]
+[!INCLUDE[github-copilot-app-mod-prereqs](./includes/prereqs.md)]
 
 ## Start the upgrade process
 
 The first step to upgrading is generating a plan by interacting with GitHub Copilot. Follow these steps to initiate the upgrade:
 
-[!INCLUDE[github-copilot-how-to-initiate](./includes/github-copilot-how-to-initiate.md)]
+[!INCLUDE[github-copilot-how-to-initiate](./includes/how-to-initiate.md)]
 
 ## Generate an upgrade plan
 
@@ -95,14 +95,14 @@ The following example shows the report of a completed upgrade that contained a t
 
 ## Project modifications
 
-| Project name                                   | Old Target Framework    | New Target Framework         | Commits                   |
-|:-----------------------------------------------|:-----------------------:|:----------------------------:|---------------------------|
-| RazorMovie                                     |   net6.0                | net9.0                       | af8cf633, aa61a18d        |
-| MvcMovie                                       |   net6.0                | net9.0                       | cc8c9015                  |
-| WpfMovie                                       |   net6.0-windows        | net9.0-windows               | 9c4b13f9                  |
-| RazorMovie.Tests                               |   net6.0                | net9.0                       | b8d85e97                  |
-| MvcMovie.Tests                                 |   net6.0                | net9.0                       | b8d85e97                  |
-| WpfMovie.Tests                                 |   net6.0-windows        | net9.0-windows7.0            | b8d85e97                  |
+| Project name     | Old Target Framework | New Target Framework | Commits            |
+|:-----------------|:--------------------:|:--------------------:|--------------------|
+| RazorMovie       | net6.0               | net9.0               | af8cf633, aa61a18d |
+| MvcMovie         | net6.0               | net9.0               | cc8c9015           |
+| WpfMovie         | net6.0-windows       | net9.0-windows       | 9c4b13f9           |
+| RazorMovie.Tests | net6.0               | net9.0               | b8d85e97           |
+| MvcMovie.Tests   | net6.0               | net9.0               | b8d85e97           |
+| WpfMovie.Tests   | net6.0-windows       | net9.0-windows7.0    | b8d85e97           |
 
 ## NuGet Packages
 
@@ -153,4 +153,4 @@ After completing the upgrade process:
 
 ## Related content
 
-- [GitHub Copilot app modernization FAQ](github-copilot-app-modernization-faq.yml)
+- [GitHub Copilot app modernization FAQ](faq.yml)
diff --git a/docs/core/porting/github-copilot-app-modernization/includes/how-to-initiate.md b/docs/core/porting/github-copilot-app-modernization/includes/how-to-initiate.md
diff --git a/docs/core/porting/github-copilot-app-modernization/includes/prereqs.md b/docs/core/porting/github-copilot-app-modernization/includes/prereqs.md
@@ -1,30 +1,30 @@
----
-author: adegeo
-ms.author: adegeo
-ms.date: 09/23/2025
-ms.topic: include
-# Shared by Azure.NET app mod and .NET app mod
----
-
-- 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 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).
-
-  Supported subscription plans:
-
-  - Copilot Pro
-  - Copilot Pro+
-  - Copilot Business
-  - Copilot Enterprise
-
-  > [!IMPORTANT]
-  > If you change subscriptions, you must restart Visual Studio.
-
-- Code must be written in C#.
+---
+author: adegeo
+ms.author: adegeo
+ms.date: 09/23/2025
+ms.topic: include
+# Shared by Azure.NET app mod and .NET app mod
+---
+
+- 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 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).
+
+  Supported subscription plans:
+
+  - Copilot Pro
+  - Copilot Pro+
+  - Copilot Business
+  - Copilot Enterprise
+
+  > [!IMPORTANT]
+  > If you change subscriptions, you must restart Visual Studio.
+
+- Code must be written in C#.
diff --git a/docs/core/porting/github-copilot-app-modernization/index.yml b/docs/core/porting/github-copilot-app-modernization/index.yml
@@ -16,30 +16,30 @@ landingContent:
       - linkListType: overview
         links:
           - text: Upgrade .NET apps
-            url: ../../core/porting/github-copilot-app-modernization-overview.md
+            url: overview.md
           - text: FAQ
-            url: ../../core/porting/github-copilot-app-modernization-faq.yml
+            url: faq.yml
       - linkListType: how-to-guide
         links:
           - text: How to upgrade a .NET app
-            url: ../../core/porting/how-to-upgrade-with-github-copilot.md
+            url: how-to-upgrade-with-github-copilot.md
 
   - 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/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json
+            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
+            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
+            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
+            url: ../../../azure/migration/appmod/faq.md?toc=/dotnet/navigate/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json
 
   - title: Get help and community
     linkLists:
diff --git a/docs/core/porting/github-copilot-app-modernization/overview.md b/docs/core/porting/github-copilot-app-modernization/overview.md
@@ -44,13 +44,13 @@ Feedback is important to Microsoft and the efficiency of this agent. Use the [Su
 
 The following items are required before you can use GitHub Copilot app modernization:
 
-[!INCLUDE[github-copilot-app-mod-prereqs](../../includes/github-copilot-app-mod-prereqs.md)]
+[!INCLUDE[github-copilot-app-mod-prereqs](./includes/prereqs.md)]
 
 ## How to start an upgrade or migration
 
 To start an upgrade or migration, interact with GitHub Copilot, following these steps:
 
-[!INCLUDE[github-copilot-how-to-initiate](./includes/github-copilot-how-to-initiate.md)]
+[!INCLUDE[github-copilot-how-to-initiate](./includes/how-to-initiate.md)]
 
 ## Upgrade .NET projects
 
@@ -170,5 +170,5 @@ The tool only collects data about project types, intent to upgrade, and upgrade
 ## Related content
 
 - [How to upgrade a .NET app with GitHub Copilot app modernization](how-to-upgrade-with-github-copilot.md)
-- [Quickstart to migrate a .NET Project](../../azure/migration/appmod/quickstart.md)
-- [GitHub Copilot app modernization FAQ](github-copilot-app-modernization-faq.yml)
+- [Quickstart to migrate a .NET Project](../../../azure/migration/appmod/quickstart.md)
+- [GitHub Copilot app modernization FAQ](faq.yml)
diff --git a/docs/core/porting/github-copilot-app-modernization/toc.yml b/docs/core/porting/github-copilot-app-modernization/toc.yml
@@ -0,0 +1,22 @@
+items:
+  - name: GitHub Copilot app modernization for .NET
+    href: index.yml
+  - name: Overview
+    href: overview.md
+  - name: FAQ
+    href: faq.yml
+    displayName: copilot, upgrade
+
+  - name: Upgrade .NET apps
+    expanded: true
+    items:
+      - name: How to upgrade with GitHub Copilot
+        href: how-to-upgrade-with-github-copilot.md
+
+  - name: Migrate .NET apps to Azure
+    expanded: true
+    items:
+      - name: Migrate a .NET project
+        href: ../../../azure/migration/appmod/quickstart.md?toc=/dotnet/core/porting/github-copilot-app-modernization/toc.json&bc=/dotnet/breadcrumb/toc.json
+      - name: Migration sample
+        href: ../../../azure/migration/appmod/sample.md?toc=/dotnet/core/porting/github-copilot-app-modernization/toc.json&bc=/dotnet/breadcrumb/toc.json
diff --git 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]
-> Try the [GitHub Copilot app modernization chat agent](../github-copilot-app-modernization-overview.md). This agent analyzes your projects and dependencies, produces a step-by-step migration plan with targeted recommendations and automated code fixes, and commits each change so you can validate or roll back. It automates common porting tasks—updating project files, replacing deprecated APIs, and resolving build issues—so you can modernize faster with less manual effort. For more information, see [What is GitHub Copilot app modernization](../github-copilot-app-modernization-overview.md).
+> Try the [GitHub Copilot app modernization chat agent](../github-copilot-app-modernization/overview.md). This agent analyzes your projects and dependencies, produces a step-by-step migration plan with targeted recommendations and automated code fixes, and commits each change so you can validate or roll back. It automates common porting tasks—updating project files, replacing deprecated APIs, and resolving build issues—so you can modernize faster with less manual effort. For more information, see [What is GitHub Copilot app modernization](../github-copilot-app-modernization/overview.md).
diff --git a/docs/core/porting/index.md b/docs/core/porting/index.md
@@ -42,4 +42,4 @@ The GitHub Copilot app modernization agent provides an AI-assisted, end-to-end e
 
 Use the GitHub Copilot app modernization 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 when you plan to containerize or migrate services to the cloud.
 
-For more information, see [What is GitHub Copilot app modernization](github-copilot-app-modernization-overview.md).
+For more information, see [What is GitHub Copilot app modernization](github-copilot-app-modernization/overview.md).
diff --git 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 app modernization](github-copilot-app-modernization-overview.md) assistant 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 app modernization](github-copilot-app-modernization/overview.md) assistant to upgrade your app to .NET.
 
 ## Missing APIs
 
diff --git a/docs/core/porting/porting-approaches.md b/docs/core/porting/porting-approaches.md
diff --git a/docs/core/porting/third-party-deps.md b/docs/core/porting/third-party-deps.md
diff --git a/docs/navigate/github-copilot-modernize/toc.yml b/docs/navigate/github-copilot-modernize/toc.yml
diff --git a/docs/navigate/migration-guide/index.yml b/docs/navigate/migration-guide/index.yml
diff --git a/docs/navigate/migration-guide/toc.yml b/docs/navigate/migration-guide/toc.yml
