Move the GitHub Copilot modernization docs to upgrade area - #55196
Open
adegeo wants to merge 26 commits into
Open
Move the GitHub Copilot modernization docs to upgrade area#55196adegeo wants to merge 26 commits into
adegeo wants to merge 26 commits into
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR reorganizes and rebrands the GitHub Copilot “modernization” content by moving the .NET upgrade-focused documentation into a new GitHub Copilot upgrade area, updating TOCs/landing pages, and reshaping the Azure-side content to focus on Azure modernization (with the modernization agent invoking the upgrade agent when needed).
Changes:
- Introduces a new
docs/core/porting/github-copilot-upgrade/doc set (overview, install, concepts, how-tos, FAQ, troubleshooting, etc). - Updates navigation (TOCs and landing pages) and cross-links across .NET porting/upgrade docs and Azure migration docs.
- Adds redirects for legacy GitHub Copilot modernization paths to the new upgrade docs.
Reviewed changes
Copilot reviewed 34 out of 36 changed files in this pull request and generated 13 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/navigate/migration-guide/toc.yml | Updates migration guide TOC links to the new Copilot upgrade docs (but currently uses a non-existent path that needs correction). |
| docs/navigate/migration-guide/index.yml | Updates migration guide landing links to the new Copilot upgrade docs (but currently uses a non-existent path and an FAQ link that should point to Azure FAQ). |
| docs/core/tools/sdk-errors/netsdk1138.md | Updates TIP link to the Copilot upgrade documentation (but currently uses a non-existent path). |
| docs/core/porting/third-party-deps.md | Updates Copilot link for dependency portability guidance (but currently uses a non-existent path). |
| docs/core/porting/porting-approaches.md | Updates next-steps Copilot link (but currently uses a non-existent path). |
| docs/core/porting/modernize.md | Updates Copilot link in modernization guidance (but currently uses a non-existent path). |
| docs/core/porting/index.md | Updates Copilot agent links in porting index (but currently uses a non-existent path). |
| docs/core/porting/includes/github-copilot-suggestion.md | Updates Upgrade Assistant deprecation include to point to Copilot upgrade (but currently uses a non-existent path). |
| docs/core/porting/github-copilot-upgrade/working-with-agent.md | Rebrands the “working with agent” article from modernization to upgrade. |
| docs/core/porting/github-copilot-upgrade/troubleshooting.md | Rebrands troubleshooting content and updates feedback repo link. |
| docs/core/porting/github-copilot-upgrade/toc.yml | Updates the Copilot upgrade doc set TOC display name and Azure migration link. |
| docs/core/porting/github-copilot-upgrade/scenarios-and-skills.md | Rebrands scenarios/skills reference for the upgrade agent. |
| docs/core/porting/github-copilot-upgrade/overview.md | Adds a new overview page describing the upgrade agent, workflow, and migration handoff to modernization. |
| docs/core/porting/github-copilot-upgrade/install.md | Rebrands install guidance and clarifies environment-specific setup. |
| docs/core/porting/github-copilot-upgrade/index.yml | Updates landing page metadata/content for the upgrade doc set. |
| docs/core/porting/github-copilot-upgrade/includes/supported-upgrade-paths.md | Adds include listing supported upgrade paths. |
| docs/core/porting/github-copilot-upgrade/includes/how-to-initiate.md | Adds include describing how to start the agent across environments. |
| docs/core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot.md | Rebrands the upgrade how-to for the upgrade agent. |
| docs/core/porting/github-copilot-upgrade/how-to-custom-upgrade-instructions.md | Updates custom-instructions article to reference the upgrade agent. |
| docs/core/porting/github-copilot-upgrade/faq.yml | Adds a new FAQ page for the upgrade agent (contains a couple of wording issues). |
| docs/core/porting/github-copilot-upgrade/customization.md | Rebrands customization article for upgrade agent. |
| docs/core/porting/github-copilot-upgrade/concepts.md | Rebrands concepts article and adjusts scenario terminology. |
| docs/core/porting/github-copilot-upgrade/best-practices.md | Rebrands best practices article for upgrade agent. |
| docs/core/porting/framework-overview.md | Updates references to the Copilot agent (but currently uses a non-existent path). |
| docs/core/install/upgrade.md | Updates TIP link to Copilot upgrade docs (but currently uses a non-existent path). |
| docs/azure/toc.yml | Points Azure Copilot modernization navigation to Azure-side pages and adds install entry. |
| docs/azure/migration/appmod/working-with-assessment.md | Updates FAQ link to Azure-side FAQ. |
| docs/azure/migration/appmod/quickstart.md | Updates FAQ link to Azure-side FAQ. |
| docs/azure/migration/appmod/overview.md | Refocuses narrative on Azure modernization and references upgrade agent when version upgrades are required. |
| docs/azure/migration/appmod/install.md | Adds Azure-side install article for modernization agent. |
| docs/azure/migration/appmod/includes/quickstart-visual-studio.md | Updates include paths and FAQ link to Azure-side FAQ. |
| docs/azure/migration/appmod/includes/github-copilot-app-modernization-prereqs.md | Updates shared prereqs include and points install link to the Azure-side install page. |
| docs/azure/migration/appmod/faq.yml | Refocuses FAQ content on Azure modernization and references upgrade agent for version upgrades. |
| docs/azure/migration/appmod/deploy.md | Updates prereq include path. |
| docs/azure/migration/appmod/containerization.md | Updates prereq include path. |
| .openpublishing.redirection.core.json | Adds redirects from legacy modernization doc paths to the new upgrade doc paths. |
Comments suppressed due to low confidence (7)
docs/core/porting/framework-overview.md:193
- This link references
github-copilot-app-upgrade/overview.md, which doesn't exist. Update it togithub-copilot-upgrade/overview.md.
✔️ CONSIDER using the [GitHub Copilot modernization](github-copilot-app-upgrade/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.
docs/core/porting/framework-overview.md:213
- The 'See also' link uses
github-copilot-app-upgrade/overview.md, but that target doesn't exist. Update it togithub-copilot-upgrade/overview.md.
- [What is GitHub Copilot modernization](github-copilot-app-upgrade/overview.md)
docs/core/porting/index.md:73
- This link uses
github-copilot-app-upgrade/overview.md, but that folder doesn't exist. Update it togithub-copilot-upgrade/overview.md.
Use the 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 that you plan to containerize or migrate to the cloud. For more information, see [What is GitHub Copilot app modernization](github-copilot-app-upgrade/overview.md).
docs/core/porting/index.md:82
- The next-steps link references
github-copilot-app-upgrade/overview.md, which doesn't exist. Update it to thegithub-copilot-upgradepath.
- [Overview of porting from .NET Framework to .NET](framework-overview.md)
- [What is GitHub Copilot app modernization](github-copilot-app-upgrade/overview.md)
docs/navigate/migration-guide/toc.yml:54
- This TOC link points to
github-copilot-app-upgrade/overview.md, but the correct folder isgithub-copilot-upgrade.
docs/navigate/migration-guide/index.yml:39 - These landing-page links still point to
github-copilot-app-upgrade, which doesn't exist in the repo. Update them togithub-copilot-upgradeso the links work.
docs/navigate/migration-guide/toc.yml:37 - The nested 'Upgrade .NET apps' TOC links reference the non-existent
github-copilot-app-upgradefolder. Update them togithub-copilot-upgradeso the TOC resolves correctly.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
adegeo
marked this pull request as ready for review
August 3, 2026 18:31
adegeo
requested review from
a team,
alexwolfmsft and
meaghanlewis
as code owners
August 3, 2026 18:31
gewarren
approved these changes
Aug 3, 2026
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
mikadumont
reviewed
Aug 3, 2026
|
|
||
| # What is GitHub Copilot modernization? | ||
|
|
||
| GitHub Copilot modernization is a GitHub Copilot agent that migrates .NET applications to Azure quickly and confidently. It guides you through assessment, solution recommendations, code fixes, and deployment across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com. |
Contributor
There was a problem hiding this comment.
Can we include GitHub Copilot app as an option at the end?
alexwolfmsft
approved these changes
Aug 3, 2026
mikadumont
reviewed
Aug 3, 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
Previews
Fixes #55008
Internal previews
Toggle expand/collapse
Note
This table shows the first 30 preview links (sorted alphabetically by file path) found in the OPS build report. For the full list, select OpenPublishing.Build Details within checks.