Update GHCP AppMod docs: scenarios, platforms, and titles#54664
Open
adegeo wants to merge 7 commits into
Open
Conversation
- Fix VS component name to 'GitHub Copilot app modernization' - Fix VS Code extension search name to 'GitHub Copilot modernization for .NET' - Add new scenarios: Aspire integration, Aspire version upgrade, WebForms-to-Blazor - Add .NET Framework 4.8.1 as supported upgrade target - Add Azure SDK migration skill and LINQ to SQL to EF Core skill - Remove execution-log.md references (file removed in agent v1.0.1087) - Update ms.date on all modified articles Fixes #54663 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the GitHub Copilot app modernization (modernize-dotnet) documentation set to match recent product changes (new scenarios/skills, updated upgrade paths, and removal of execution-log.md references), and refreshes article metadata dates.
Changes:
- Add new scenarios (Aspire integration, Aspire version upgrade, and WebForms-to-Blazor upgrade) and new skills (Azure SDK migration, and LINQ to SQL to EF Core) to the reference content.
- Document the added upgrade target of .NET Framework 4.8.1 and remove
execution-log.mdreferences in favor of task progress artifacts. - Update installation naming to match Visual Studio optional component and VS Code extension listing, plus refresh
ms.dateacross the set.
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/core/porting/github-copilot-app-modernization/working-with-agent.md | Removes execution-log.md references and refreshes ms.date. |
| docs/core/porting/github-copilot-app-modernization/troubleshooting.md | Replaces execution-log.md guidance with per-task progress details and refreshes ms.date. |
| docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md | Adds new scenarios/skills and updates upgrade-path tables. |
| docs/core/porting/github-copilot-app-modernization/overview.md | Adds new scenarios and updates upgrade-path/state-artifact tables. |
| docs/core/porting/github-copilot-app-modernization/install.md | Updates Visual Studio component name and VS Code extension search name. |
| docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md | Refreshes ms.date. |
| docs/core/porting/github-copilot-app-modernization/faq.yml | Updates upgrade-path table and refreshes ms.date. |
| docs/core/porting/github-copilot-app-modernization/customization.md | Refreshes ms.date. |
| docs/core/porting/github-copilot-app-modernization/concepts.md | Removes execution-log.md reference and refreshes ms.date. |
| docs/core/porting/github-copilot-app-modernization/best-practices.md | Refreshes ms.date. |
Move the repeated supported upgrade paths table into includes/supported-upgrade-paths.md and reference it from overview.md, scenarios-and-skills.md, and faq.yml. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
gewarren
approved these changes
Jul 7, 2026
|
|
||
| ## Install | ||
|
|
||
| Install through the Visual Studio Code: |
Collaborator
There was a problem hiding this comment.
Suggested change
| Install through the Visual Studio Code: | |
| Install as a Visual Studio Code extension: |
|
|
||
| 1. Review [adding custom coding agents to your repository](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents). | ||
| 1. Add the `modernize-dotnet` agent. See the [coding agent README](https://github.com/dotnet/modernize-dotnet/blob/main/coding-agent/README.md) for details. | ||
| 1. Click on [this link](https://github.com/copilot/app/launch?entry_point=upgrade_agent_docs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Fupgrade-agent-plugins) to automatically open the **Settings** > **Plugins** window in the GitHub Copilot app. |
Collaborator
There was a problem hiding this comment.
Suggested change
| 1. Click on [this link](https://github.com/copilot/app/launch?entry_point=upgrade_agent_docs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Fupgrade-agent-plugins) to automatically open the **Settings** > **Plugins** window in the GitHub Copilot app. | |
| 1. Click [https://github.com/copilot/app/launch](https://github.com/copilot/app/launch?entry_point=upgrade_agent_docs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Fupgrade-agent-plugins) to automatically open the **Settings** > **Plugins** window in the GitHub Copilot app. |
| | **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 integration** | Adds .NET Aspire support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | | |
| | **Aspire integration** | Adds [Aspire](https://aspire.dev) support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | |
| | [**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 integration**](#aspire-integration) | Adds .NET Aspire support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | | |
| | [**Aspire integration**](#aspire-integration) | Adds [Aspire](https://aspire.dev) support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | |
|
|
||
| ### 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
| 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. | |
| Adds [Aspire](https://aspire.dev) support to existing applications for inner-loop development and Azure deployment. Configures the Aspire orchestration layer and integrates with the Aspire CLI agent. |
|
|
||
| ### 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
| Upgrades existing .NET Aspire applications to newer versions of Aspire. Handles package updates, configuration changes, and breaking API changes between Aspire versions. | |
| Upgrades existing Aspire applications to newer versions of Aspire. Handles package updates, configuration changes, and breaking API changes between Aspire versions. |
wadepickett
reviewed
Jul 7, 2026
| 1. Open the **GitHub Copilot Chat** window. | ||
| 1. Send `@upgrade` in chat and see if it responds. | ||
|
|
||
| \-or- |
Contributor
There was a problem hiding this comment.
Suggested change
| \-or- | |
| -or- |
Seperator was escaped or was a typo, elsewhere -or- is used so making this one the same.
wadepickett
reviewed
Jul 7, 2026
| 1. Open a project in Visual Studio Code. | ||
| 1. Open **GitHub Copilot Chat** and type `@modernize-dotnet`. | ||
| 1. Open the **GitHub Copilot Chat** window. | ||
| 1. Send `@upgrade` in chat and see if it responds. |
Contributor
There was a problem hiding this comment.
Suggested change
| 1. Send `@upgrade` in chat and see if it responds. | |
| 1. Send `@upgrade` in chat and confirm the agent responds. |
Very minor: take or leave.
wadepickett
approved these changes
Jul 7, 2026
wadepickett
left a comment
wadepickett
left a comment
Contributor
There was a problem hiding this comment.
@adegeo, approved, assuming gewarrent suggestions are addressed. I found a couple super minor items. Looks great.
wadepickett
approved these changes
Jul 8, 2026
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Summary
Updates GitHub Copilot modernization documentation to reflect latest product changes from the modernize-dotnet CHANGELOG.
Changes
Naming fixes
New scenarios added
Updated supported upgrade paths
New skills added
Removed references
execution-log.md(removed from the agent in v1.0.1087-preview1)Articles updated
install.mdoverview.mdscenarios-and-skills.mdconcepts.mdworking-with-agent.mdtroubleshooting.mdfaq.ymlbest-practices.mdhow-to-upgrade-with-github-copilot.mdcustomization.mdFixes #54663
Internal previews
Toggle expand/collapse