Miscellaneous fixes to app modernization docs (#46312)

Author: gewarren

docs/core/compatibility/extensions/10.0/provideraliasattribute-moved-assembly.md

@@ -2,6 +2,7 @@
 title: "Breaking change: ProviderAliasAttribute moved to Microsoft.Extensions.Logging.Abstractions assembly"
 description: Learn about the breaking change in .NET 10 where the ProviderAliasAttribute class moved from the Microsoft.Extensions.Logging assembly to the Microsoft.Extensions.Logging.Abstractions assembly.
 ms.date: 05/19/2025
+ai-usage: ai-assisted
 ---
 
 # ProviderAliasAttribute moved to Microsoft.Extensions.Logging.Abstractions

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

@@ -17,21 +17,21 @@ sections:
     questions:
       - question: What can the tool do?
         answer: |
-          Currently, 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 - 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:
 
-          - Analyze your projects and proposes an upgrade plan.
+          - Analyzes your projects and proposes an upgrade plan.
           - According to the plan, runs a series of tasks to upgrade your projects.
           - Operates in a working branch under a local Git repository.
-          - Automatically fix issues during the code transformation.
-          - Report progress and allow access to code changes & logs.
+          - Automatically fixes issues during the code transformation.
+          - 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?
         answer: |
-          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.
+          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.
 
           Besides upgrading the target framework, the tool can work with the following types of projects:
-          
+
           - Azure Functions.
           - Console apps and class libraries.
           - Web technologies such as:
@@ -44,26 +44,27 @@ sections:
 
       - question: What limitations are there?
         answer: |
-          - It doesn't support .NET Framework projects. (First upgrade the project to .NET with the [Upgrade Assistant tool](upgrade-assistant-overview.md))
+          - It doesn't support .NET Framework projects. (First upgrade the project to .NET with the [Upgrade Assistant tool](upgrade-assistant-overview.md).)
           - 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: What data is collected?
         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).
 
       - question: Can I disable telemetry?
         answer: |
-          Yes, you can disable telemetry through Visual Studio itself. In Visual Studio, select **Help** > **Privacy** > **Privacy Settings** > **"No, I would not like to participate."**
+          Yes, you can disable telemetry. In Visual Studio, select **Help** > **Privacy** > **Privacy Settings** > **"No, I would not like to participate."**
 
       - 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.
+          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.
 
-          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. 
+          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.
 
 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 - upgrade for .NET?](github-copilot-app-modernization-overview.md).

docs/core/porting/github-copilot-app-modernization-install.md

@@ -17,11 +17,11 @@ This article guides you through installing GitHub Copilot app modernization - up
 
 ## Prerequisites
 
-- Windows Operating System
-- [Visual Studio 2022 version 17.14 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).
+- Windows operating system
+- [Visual Studio 2022 version 17.14 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)
 
-## Visual Studio Extension
+## Visual Studio extension
 
 The following steps install the Visual Studio extension.
 
@@ -32,12 +32,12 @@ The following steps install the Visual Studio extension.
 
     If the **Open Recent \ Get Started** window opens, select the **Continue without code** link.
 
-01. Select the **Extensions** > **Manage Extensions** menu to open the **Extension Manager** window.
+01. Select the **Extensions** > **Manage Extensions** menu to open **Extension Manager**.
 01. Select the **Browse** tab.
-01. Type **GitHub Copilot App Modernization** into the search box.
-01. Select the **GitHub Copilot App Modernization** item, and then select **Install**.
+01. Enter `GitHub Copilot app modernization` into the search box.
+01. Select **GitHub Copilot app modernization**, and then select **Install**.
 
-    :::image type="content" source="media/github-copilot-app-modernization-install/visual-studio-manage-extensions.png" alt-text="The manage extensions window in Visual Studio, showing the GitHub Copilot App Modernization.":::
+    :::image type="content" source="media/github-copilot-app-modernization-install/visual-studio-manage-extensions.png" alt-text="The manage extensions window in Visual Studio, showing GitHub Copilot app modernization.":::
 
 01. Once the extension finishes downloading, close Visual Studio to automatically start the installation.
 
@@ -47,11 +47,10 @@ The following steps install the Visual Studio extension.
 
 ## Validation
 
-The following information helps you determine that GitHub Copilot App Modernization is installed.
+There are two ways to determine if GitHub Copilot App Modernization is installed as a Visual Studio extension:
 
-There are two ways to determine if GitHub Copilot App Modernization is installed as a Visual Studio extension. The quickest way is to right-click on any .NET or .NET Framework project in the **Solution Explorer** window and check for an **Upgrade** menu item.
-
-Another way is to select the **Extensions** > **Manage Extensions** menu to open the **Extension Manager** window. Then, select the **Installed** tab and find it in the list of installed extensions.
+- The quickest way is to right-click on any .NET or .NET Framework project in **Solution Explorer** and check for an **Upgrade** menu item.
+- Another way is to select the **Extensions** > **Manage Extensions** menu to open the **Extension Manager** window. Then, select the **Installed** tab and find it in the list of installed extensions.
 
 ## Related content
 

docs/core/porting/github-copilot-app-modernization-overview.md

@@ -1,5 +1,5 @@
 ---
-title: GitHub Copilot app modernization - upgrade for .NET Overview
+title: GitHub Copilot app modernization - upgrade for .NET overview
 description: "Learn more about GitHub Copilot app modernization - upgrade for .NET. This Visual Studio extension helps you upgrade your code and projects. Upgrades can include .NET versioning or migrating code from one technology to another."
 titleSuffix: ""
 author: adegeo
@@ -13,7 +13,7 @@ ms.date: 05/16/2025
 
 # What is GitHub Copilot app modernization - upgrade for .NET?
 
-GitHub Copilot app modernization - upgrade for .NET is a powerful Visual Studio extension that works with you to upgrade projects to newer versions of .NET, upgrade your dependencies, and applies code fixes.
+GitHub Copilot app modernization - upgrade for .NET is a powerful Visual Studio extension that works with you to upgrade projects to newer versions of .NET, upgrade your dependencies, and apply code fixes.
 
 GitHub Copilot app modernization is distributed as a Visual Studio extension, and is an interactive upgrade process.
 
@@ -70,12 +70,12 @@ The first step to upgrading is generating a plan by interacting with GitHub Copi
 
 ## Generate a plan
 
-Once the process starts, Copilot analyzes your projects and their dependencies, and then asks you a series of questions about the upgrade. After you answer these questions, an upgrade plan is written in the form of a markdown file. If you tell Copilot to proceed with the upgrade, this plan describes the steps of the upgrade process.
+Once the process starts, Copilot analyzes your projects and their dependencies, and then asks you a series of questions about the upgrade. After you answer these questions, an upgrade plan is written in the form of a Markdown file. If you tell Copilot to proceed with the upgrade, this plan describes the steps of the upgrade process.
 
-You can adjust the plan by editing the markdown file to change the upgrade steps or add more context.
+You can adjust the plan by editing the Markdown file to change the upgrade steps or add more context.
 
 > [!CAUTION]
-> The plan is generated based on the inter-dependencies of your projects. You can prevent the upgrade from succeeding if you modify the plan in such a way that the migration path can't complete. For example, if **Project A** depends on **Project B** and you remove **Project B** from the upgrade plan, upgrading **Project A** might fail.
+> The plan is generated based on the inter-dependencies of your projects. The upgrade won't succeed if you modify the plan in such a way that the migration path can't complete. For example, if **Project A** depends on **Project B** and you remove **Project B** from the upgrade plan, upgrading **Project A** might fail.
 
 The following snippet demonstrates the structure of a plan:
 
@@ -114,7 +114,7 @@ NuGet packages used across all selected projects or their dependencies that need
 
 ## Perform the upgrade
 
-Once an upgrade plan is ready, tell the Copilot to start the upgrade. Once the upgrade process starts, Copilot lets you know what it's doing in the chat window and it opens the **Upgrade Progress Details** document, which lists the status of every step. If it runs into a problem, Copilot pauses and asks for your direction or help in fixing these problems.
+Once an upgrade plan is ready, tell Copilot to start the upgrade. Once the upgrade process starts, Copilot lets you know what it's doing in the chat window and it opens the **Upgrade Progress Details** document, which lists the status of every step. If it runs into a problem, Copilot pauses and asks for your direction or help in fixing these problems.
 
 The tool differs in experience based on whether or not Copilot _agent mode_ is enabled.