Rework the .NET GitHub Copilot content and modernize/upgrade/migrate related content (#48319)

* Test TOC

* More adjustments

* changes

* Moar

* restructure

* alter toc/bread

* minor

* Start rewriting intros

* moar updates

* Moar changes yet againz!

* mooore

* Fix link text in FAQ

* Fix more titles

* Remove temp file

* Remove refs to upgrade assist; add ghcp app mod

* Adjust link title

* Dates

* Rewrite landing

* Fix link

* Fix links

* build errs

* Fix landing

* Restructure and add how-to

* Add howto in card

* Add link

* Add snippets back

* Add more information

* TOC move FAQ

* Split content into differnet TOCs

* Fix the TOC crosslinking

* Actually fix the TOC crosslinking

* Adjust #

* Adjust TOC

* Add the predefined info

* Fix term

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

* Feedback fixes

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

---------

Co-authored-by: Genevieve Warren <[email protected]>

Author: adegeo

docs/azure/migration/appmod/overview.md

@@ -47,7 +47,7 @@ For more information, see [Predefined tasks](predefined-tasks.md).
 
 ### Upgrading .NET projects
 
-Upgrading .NET apps is a common task that requires substantial time and resources. GitHub Copilot App Modernization - upgrade for .NET provides an AI-based solution designed to assist with updating your .NET apps. For more information, see [GitHub Copilot App Modernization - upgrade for .NET](../../../core/porting/github-copilot-app-modernization-overview.md).
+Upgrading .NET apps is a common task that requires substantial time and resources. GitHub Copilot app modernization is an AI-based solution designed to assist with updating your .NET apps. For more information, see [GitHub Copilot app modernization](../../../core/porting/github-copilot-app-modernization-overview.md).
 
 ## Common use cases
 

docs/core/porting/framework-overview.md

@@ -6,11 +6,11 @@ metadata:
   author: adegeo
   ms.author: adegeo
   ms.topic: faq
-  ms.date: 09/04/2025
+  ms.date: 09/15/2025
 
-title: GitHub Copilot app modernization - upgrade for .NET FAQ
+title: GitHub Copilot app modernization FAQ
 summary: |
-  GitHub Copilot app modernization - upgrade for .NET is an interactive GitHub Copilot extension that adds powerful upgrade capabilities to Visual Studio. This article answers frequently asked questions. For more information about the tool, see [What is GitHub Copilot app modernization - upgrade for .NET?](github-copilot-app-modernization-overview.md).
+  GitHub Copilot app modernization is an interactive GitHub Copilot agent that adds powerful upgrade 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).
 
   The tool requires one of the following GitHub Copilot subscriptions:
 
@@ -19,12 +19,14 @@ summary: |
   - Copilot Business
   - Copilot Enterprise
 
+  GitHub Copilot app modernization is included in [Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/).
+
 sections:
-  - name: Scenarios
+  - name: Modernization agent
     questions:
-      - question: What can the tool do?
+      - question: What can the agent do?
         answer: |
-          Currently, GitHub Copilot app modernization - upgrade for .NET helps you upgrade your .NET projects to newer versions of .NET. The tool is an extension for Visual Studio that performs the following steps in a GitHub Copilot chat session:
+          Currently, GitHub Copilot app modernization helps you upgrade your .NET (.NET, .NET Core, and .NET Framework) projects to newer versions of .NET. It also helps migrate services to Azure. It also upgrades dependencies and fixes errors in the code post-migration. The agent performs the following steps in a GitHub Copilot chat session:
 
           - Analyzes your projects and proposes an upgrade plan.
           - According to the plan, runs a series of tasks to upgrade your projects.
@@ -33,11 +35,44 @@ sections:
           - Reports progress and allow access to code changes & logs.
           - Learns from the interactive experience with you (within the context of the session) to improve subsequent transformations.
 
-      - question: What can the tool upgrade?
+      - question: What limitations are there?
+        answer: |
+          - Only Git repositories are supported.
+          - There's no guarantee that the upgrade suggestions are considered best practices.
+          - The LLM doesn't persist learning from the upgrade. Meaning, code fixes and corrections you provide during the upgrade process don't persist and can't be remembered for future upgrades.
+          - It only runs on Windows.
+
+      - question: Which model should I use?
         answer: |
-          GitHub Copilot app modernization - upgrade for .NET currently focuses on migrating your projects from one version of .NET to another. For example, upgrading from .NET Core 3.1 or .NET 6, to .NET 9. It also upgrades dependencies and fixes errors in the code post-migration.
+          You should use a good coding model, such as Claude Sonnet 4.0 or Claude Sonnet 3.7.
 
-          Besides upgrading the target framework, the tool can work with the following types of projects:
+      - 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 more structured way. The AI is embedded within the build-and-fix process, meaning the prompts it uses are predefined and tied to the upgrade plan. So it's not something you can train on your codebase, and it's not something you can manually steer with custom instructions, beyond the changes you can make to the plan Markdown file.
+
+          However, the agent does have some adaptability within a session. If you manually adjust a fix, it learns from that interaction in the short term and applies similar corrections if it encounters the same issue again. Think of it as refining its approach within the scope of that upgrade.
+
+      - question: Does the agent store my source code?
+        answer: |
+          The agent never stores a user's codebase and never uses your code for training the model. Once an upgrade is complete, session data is deleted.
+
+      - question: Can I provide feedback?
+        answer: |
+          Yes! Use the [Suggest a feature](/visualstudio/ide/suggest-a-feature) and [Report a Problem](/visualstudio/ide/report-a-problem) features of in Visual Studio to provide feedback.
+
+      - question: What data is collected?
+        answer: |
+          The agent only collects telemetry information about project types, intent to upgrade, and upgrade duration. The data is aggregated through Visual Studio itself 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=vs-2022).
+
+      - question: Can I disable telemetry?
+        answer: |
+          Yes, you can disable telemetry. In Visual Studio, select **Help** > **Privacy** > **Privacy Settings** > **"No, I would not like to participate."**
+
+  - name: Upgrade .NET apps
+    questions:
+      - question: What can the agent upgrade?
+        answer: |
+          GitHub Copilot app modernization helps you upgrade your .NET projects or migrate them to Azure. Besides upgrading the target framework, the agent can work with the following types of projects:
 
           - Azure Functions.
           - Console apps and class libraries.
@@ -50,28 +85,30 @@ sections:
           - Test projects such as MSTest and NUnit.
           - .NET Framework projects.
 
-      - question: What limitations are there?
+  - name: Migrate to Azure
+    questions:
+      - question: What can the agent migrate?
         answer: |
-          - Only Git repositories are supported.
-          - There's no guarantee that the upgrade suggestions are considered best practices.
-          - The LLM doesn't persist learning from the upgrade. Meaning, code fixes and corrections you provide during the upgrade process don't persist and can't be remembered for future upgrades.
-          - It only runs on Windows.
+          The agent can assist in migrating your .NET applications to Azure, including:
+          - Web apps
+          - API apps
+          - Azure Functions
+          - Containerized applications
 
-      - question: What data is collected?
+      - question: Can I monitor assessment progress?
         answer: |
-          The tool only collects telemetry information about project types, intent to upgrade, and upgrade duration. The data is aggregated through Visual Studio itself 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=vs-2022).
+          Yes, you can monitor the progress of the assessment through the Visual Studio interface. The agent provides real-time feedback and updates on the status of the migration process.
 
-      - question: Can I disable telemetry?
-        answer: |
-          Yes, you can disable telemetry. In Visual Studio, select **Help** > **Privacy** > **Privacy Settings** > **"No, I would not like to participate."**
+          While the assessment is running, you can monitor its progress by viewing the command-line output:
 
-      - question: Can I train the model based on my code base?
-        answer: |
-          No. Unlike traditional AI tools where you might enter freeform prompts, the tool operates in a more structured way. The AI is embedded within the build-and-fix process, meaning the prompts it uses are predefined and tied to the upgrade plan. So it's not something you can train on your codebase, and it's not something you can manually steer with custom instructions, beyond the changes you can make to the plan Markdown file.
+          1. In Visual Studio, go to **View** > **Output** to open the Output window.
+          2. In the Output window, find the **Show output from:** dropdown.
+          3. Select **AppModernizationExtension** from the dropdown list.
+          4. The command-line output from the assessment tool appears here, showing real-time progress.
 
-          However, the tool does have some adaptability within a session. If you manually adjust a fix, it learns from that interaction in the short term and applies similar corrections if it encounters the same issue again. Think of it as refining its approach within the scope of that upgrade. We never store a user's codebase and never use your code for training the model. Once an upgrade is complete, session data is deleted and not stored.
+          You can also access the **Output** window using the keyboard shortcut <kbd>Ctrl+Alt+O</kbd>.
 
 additionalContent: |
     ## Related content
 
-    To learn more, see [What is GitHub Copilot app modernization - upgrade for .NET?](github-copilot-app-modernization-overview.md).
+    To learn more, see [What is GitHub Copilot app modernization?](github-copilot-app-modernization-overview.md).

docs/core/porting/github-copilot-app-modernization-faq.yml

@@ -1,24 +1,27 @@
 ---
-title: Install GitHub Copilot app modernization - upgrade for .NET
-description: "Learn how to install the GitHub Copilot app modernization - upgrade for .NET Visual Studio extension. App modernization assists you when upgrading projects to the latest dependencies or when upgrading to a new version of .NET"
+title: Install GitHub Copilot app modernization
+description: "Learn how to install the GitHub Copilot app modernization Visual Studio extension. App modernization assists you when upgrading projects to the latest dependencies or when upgrading to a new version of .NET"
 titleSuffix: ""
 author: adegeo
 ms.author: adegeo
 ms.topic: install-set-up-deploy
-ms.date: 09/04/2025
+ms.date: 09/15/2025
 
 #customer intent: As a developer, I want to install GitHub Copilot App Modernization so that I can upgrade my projects.
 
 ---
 
-# Install GitHub Copilot app modernization - upgrade for .NET
+# Install GitHub Copilot app modernization
 
-This article guides you through installing GitHub Copilot app modernization - upgrade for .NET extension in Visual Studio.
+This article guides you through installing the GitHub Copilot app modernization extension in Visual Studio.
+
+> [!IMPORTANT]
+> The GitHub Copilot Modernization agent is included in Visual Studio, starting with Visual Studio 2022 17.14.16 and Visual Studio 2026.
 
 ## Prerequisites
 
 - Windows operating system
-- [Visual Studio 2022 version 17.14 or newer](https://visualstudio.microsoft.com/downloads/)
+- [Visual Studio 2022 version 17.14.15 or earlier](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)
 
 While not required to _install_ the extension, to use the extension you must [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).
@@ -65,4 +68,4 @@ There are two ways to determine if GitHub Copilot App Modernization is installed
 
 ## Related content
 
-- [What is GitHub Copilot app modernization - upgrade for .NET?](github-copilot-app-modernization-overview.md)
+- [What is GitHub Copilot app modernization?](github-copilot-app-modernization-overview.md)