Update GHCP AppMod docs: scenarios, platforms, and titles #54664
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| --- | ||
| author: adegeo | ||
| ms.author: adegeo | ||
| ms.date: 07/07/2026 | ||
| ms.topic: include | ||
| --- | ||
|
|
||
| | Source | Target | | ||
| |------------------------------|---------------------------| | ||
| | .NET Framework (any version) | .NET 8 or later | | ||
| | .NET Framework (any version) | .NET Framework 4.8.1 | | ||
| | .NET Core 1.x–3.x | .NET 8 or later | | ||
| | .NET 5 or later | .NET 8 or later | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -3,7 +3,7 @@ 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." | ||||||
| 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 modernization is, so that I understand its capabilities and how I can take advantage of it. | ||||||
|
|
@@ -36,6 +36,9 @@ The agent provides multiple end-to-end modernization workflows called _scenarios | |||||
| | **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 .NET Aspire support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | | ||||||
|
Collaborator
There was a problem hiding this comment.
Suggested change
|
||||||
| | **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). | ||||||
|
|
||||||
|
|
@@ -45,7 +48,7 @@ Microsoft values your feedback and uses it to improve the agent. Leave feedback | |||||
|
|
||||||
| - 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 | ||||||
|
|
||||||
|
|
@@ -73,11 +76,7 @@ To start an upgrade, see [Upgrade a .NET app with GitHub Copilot modernization]( | |||||
|
|
||||||
| The agent supports the following upgrade paths: | ||||||
|
|
||||||
| [!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] | ||||||
|
|
||||||
| ## Migrate .NET projects to Azure | ||||||
|
|
||||||
|
|
@@ -193,7 +192,6 @@ The agent stores all upgrade state in `.github/upgrades/{scenarioId}/`. The fold | |||||
| | `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 | | ||||||
|
|
||||||
|
|
||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -2,7 +2,7 @@ | |||||
| 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." | ||||||
| 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. | ||||||
|
|
@@ -33,18 +33,17 @@ Scenarios are the agent's top-level upgrade workflows. When you start a conversa | |||||
| | [**SqlClient upgrade**](#sqlclient-upgrade) | Upgrades System.Data.SqlClient to Microsoft.Data.SqlClient. | _"Update SqlClient to the modern package"_ | | ||||||
| | [**Azure Functions upgrade**](#azure-functions-upgrade) | Upgrades Azure Functions from in-process to isolated worker model. | _"Upgrade my Azure Functions"_ | | ||||||
| | [**Semantic Kernel to Agents**](#semantic-kernel-to-microsoft-agent-framework) | Upgrades from SK Agents to Microsoft Agent Framework. | _"Upgrade my SK agents"_ | | ||||||
| | [**Aspire integration**](#aspire-integration) | Adds .NET Aspire support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | | ||||||
|
Collaborator
There was a problem hiding this comment.
Suggested change
|
||||||
| | [**Aspire version upgrade**](#aspire-version-upgrade) | Upgrades existing Aspire applications to newer versions. | _"Upgrade my Aspire version"_ | | ||||||
| | [**WebForms-to-Blazor upgrade**](#webforms-to-blazor-upgrade) | Upgrades ASP.NET Web Forms applications to Blazor. | _"Migrate my Web Forms app to Blazor"_ | | ||||||
|
|
||||||
| For an end-to-end walkthrough, see [Core concepts](concepts.md). | ||||||
|
|
||||||
| ### .NET version upgrade | ||||||
|
|
||||||
| The most common scenario. Upgrades your projects from any older .NET variant to the latest: | ||||||
|
|
||||||
| [!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] | ||||||
|
|
||||||
| The agent analyzes your dependency graph, checks NuGet compatibility, identifies breaking changes, and creates a task plan using the best strategy for your solution (bottom-up, top-down, or all-at-once). If your projects need format conversions, the agent handles them automatically as part of the upgrade. | ||||||
|
|
||||||
|
|
@@ -68,6 +67,18 @@ Upgrades Azure Functions from the in-process hosting model to the isolated worke | |||||
|
|
||||||
| Upgrades from Semantic Kernel Agents (`ChatCompletionAgent`, `OpenAIAssistantAgent`) to [Microsoft Agent Framework](/agent-framework/overview/). Updates packages and API patterns. | ||||||
|
|
||||||
| ### Aspire integration | ||||||
|
|
||||||
| Adds .NET Aspire support to existing applications for inner-loop development and Azure deployment. Configures the Aspire orchestration layer and integrates with the Aspire CLI agent. | ||||||
|
Collaborator
There was a problem hiding this comment.
Suggested change
|
||||||
|
|
||||||
| ### Aspire version upgrade | ||||||
|
|
||||||
| Upgrades existing .NET Aspire applications to newer versions of Aspire. Handles package updates, configuration changes, and breaking API changes between Aspire versions. | ||||||
|
Collaborator
There was a problem hiding this comment.
Suggested change
|
||||||
|
|
||||||
| ### WebForms-to-Blazor upgrade | ||||||
|
|
||||||
| Upgrades ASP.NET Web Forms applications to Blazor using native Blazor and HTML5 patterns. Converts Web Forms pages, controls, and code-behind to Blazor components. | ||||||
|
|
||||||
| ## Upgrade skills: common | ||||||
|
|
||||||
| General-purpose upgrade skills that apply across project types. | ||||||
|
|
@@ -94,6 +105,7 @@ Skills for upgrading data access layers, including Entity Framework, LINQ to SQL | |||||
| | **Upgrading EDMX to Code-First** | Converts EF6 Database-First (`.edmx`) models to EF Core Code-First. Scaffolds entities from the database. | | ||||||
| | **Upgrading EF DbContext** | Registers `DbContext` in ASP.NET Core dependency injection. Handles both EF6 to EF Core and existing EF Core patterns. | | ||||||
| | **Upgrading EF6 Code-First to EF Core** | Upgrades EF6 Code-First to EF Core. Swaps packages, updates namespaces, and replaces `EntityTypeConfiguration` and `DbModelBuilder`. | | ||||||
| | **Upgrading LINQ to SQL to EF Core** | Migrates LINQ to SQL (`System.Data.Linq`) data access to Entity Framework Core. | | ||||||
| | **Upgrading to Microsoft.Data.SqlClient** | Upgrades from `System.Data.SqlClient`. Handles the `Encrypt=true` default change and connection string differences. | | ||||||
|
|
||||||
| ## Upgrade skills: web and ASP.NET | ||||||
|
|
@@ -147,6 +159,7 @@ Skills for upgrading ASP.NET Framework applications to ASP.NET Core. | |||||
| | **Upgrading Azure Functions Startup** | Upgrades Azure Functions from the in-process `Startup` class to isolated worker model with `Program.cs`. | | ||||||
| | **Upgrading Azure Functions to v2** | Upgrades Azure Functions to the v2 hosting pattern using `IHostApplicationBuilder`. | | ||||||
| | **Upgrading Azure Key Vault** | Upgrades legacy Azure Key Vault SDK to the modern `Azure.Security.KeyVault` libraries. | | ||||||
| | **Upgrading Azure SDK** | Upgrades legacy Azure SDK dependencies to the latest `Azure.*` libraries. | | ||||||
| | **Upgrading Azure Service Bus** | Upgrades legacy Azure Service Bus SDK to the modern `Azure.Messaging.ServiceBus` library. | | ||||||
| | **Upgrading Azure Storage** | Upgrades legacy Azure Storage SDK to the modern `Azure.Storage` libraries. | | ||||||
|
|
||||||
|
|
||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -2,7 +2,7 @@ | |
| 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." | ||
| 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. | ||
|
|
@@ -76,7 +76,7 @@ These issues relate to build failures, NuGet restore problems, and code generati | |
|
|
||
| 1. Tell the agent about the failure. The agent analyzes errors automatically. | ||
| 1. If the agent can't resolve the issue, revert the last commit (`git revert HEAD`) and ask the agent to try a different approach. | ||
| 1. For complex failures, check `tasks.md` to find the failing task ID, and then review `tasks/{taskId}/progress-details.md` to understand what the agent changed and in what order. | ||
|
|
||
| ### NuGet restore fails | ||
|
|
||
|
|
@@ -185,7 +185,7 @@ These issues relate to custom skills and scenario instruction files. | |
| 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). | ||
|
|
||
| ## Related content | ||
|
|
||
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.