Skip to content

Conversation

gewarren
Copy link
Contributor

@gewarren gewarren commented Oct 1, 2025

Follow up to #48809, which wasn't quite correct.

  • Adds subfolder for GitHub Copilot app modernization so its TOC and index can live alongside its articles (the navigate folder should only be used as a last resort - it was a necessity since our content was spread out over core/standard/etc. folders so there was no obvious place to add the navigation files).
  • Removes troubleshooting links for Azure since the previous target now redirects to the GitHub Copilot app modernization FAQ.

Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/azure/migration/appmod/containerization.md Quickstart: Containerize your project using GitHub Copilot app modernization for .NET
docs/azure/migration/appmod/deploy.md Deploy your project to Azure by using GitHub Copilot app modernization for .NET
docs/azure/migration/appmod/quickstart.md Quickstart: Assess and migrate a .NET project with GitHub Copilot app modernization for .NET
docs/azure/toc.yml docs/azure/toc
docs/core/install/upgrade.md Upgrade to a new .NET version
docs/core/porting/framework-overview.md Overview of porting from .NET Framework to .NET
docs/core/porting/github-copilot-app-modernization/faq.yml GitHub Copilot app modernization FAQ
docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md How to upgrade a .NET app with GitHub Copilot app modernization
docs/core/porting/github-copilot-app-modernization/index.yml docs/core/porting/github-copilot-app-modernization/index
docs/core/porting/github-copilot-app-modernization/overview.md What is GitHub Copilot app modernization?
docs/core/porting/github-copilot-app-modernization/toc.yml docs/core/porting/github-copilot-app-modernization/toc
docs/core/porting/index.md Overview of upgrading .NET apps
docs/core/porting/modernize.md Modernize after upgrading to .NET from .NET Framework
docs/core/porting/porting-approaches.md Porting approaches
docs/core/porting/third-party-deps.md Analyze your dependencies to port code from .NET Framework to .NET
docs/navigate/migration-guide/index.yml docs/navigate/migration-guide/index
docs/navigate/migration-guide/toc.yml docs/navigate/migration-guide/toc

@gewarren
Copy link
Contributor Author

gewarren commented Oct 1, 2025

MSDocs build verifier error is a false positive. That's tracked by dotnet/docs-tools#36.

I worked around it by manually adding the redirect file to the OPS publish config.

@gewarren gewarren marked this pull request as ready for review October 1, 2025 20:09
@gewarren gewarren requested review from adegeo, a team and alexwolfmsft as code owners October 1, 2025 20:09
@gewarren gewarren requested a review from BillWagner October 3, 2025 22:26
@Copilot Copilot AI review requested due to automatic review settings October 6, 2025 20:29
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR consolidates GitHub Copilot app modernization content by creating a dedicated subfolder structure and updating all related references. The changes move files from scattered locations into a centralized github-copilot-app-modernization folder within the core porting documentation, improving content organization and maintainability.

  • Creates a new subfolder structure for GitHub Copilot app modernization content with its own TOC and index files
  • Updates all internal references to point to the new file locations
  • Removes the old navigation structure and sets up proper redirections for moved content

Reviewed Changes

Copilot reviewed 22 out of 24 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
docs/navigate/migration-guide/toc.yml Updates navigation links to point to new subfolder locations
docs/navigate/migration-guide/index.yml Updates landing page links to new file paths
docs/navigate/github-copilot-modernize/toc.yml Removes old navigation file (deleted)
docs/core/porting/third-party-deps.md Updates reference link to new subfolder location
docs/core/porting/porting-approaches.md Updates reference link and fixes minor text improvements
docs/core/porting/modernize.md Updates reference link to new subfolder location
docs/core/porting/index.md Updates reference link to new subfolder location
docs/core/porting/includes/github-copilot-suggestion.md Updates include file references to new locations
docs/core/porting/github-copilot-app-modernization/toc.yml Creates new navigation structure for the subfolder
docs/core/porting/github-copilot-app-modernization/overview.md Updates internal references and include paths
docs/core/porting/github-copilot-app-modernization/index.yml Updates landing page links to relative paths
docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md Updates include references and fixes table formatting
docs/core/porting/github-copilot-app-modernization/faq.yml Updates internal references to use relative paths
docs/core/porting/framework-overview.md Updates reference links to new subfolder location
docs/core/install/upgrade.md Updates reference link to new subfolder location
docs/azure/toc.yml Updates Azure navigation links to new file paths
docs/azure/migration/appmod/quickstart.md Updates include reference to new location
docs/azure/migration/appmod/deploy.md Updates include reference to new location
docs/azure/migration/appmod/containerization.md Updates include reference to new location
.openpublishing.redirection.navigate.json Creates redirection for old navigate structure
.openpublishing.redirection.core.json Adds redirections for moved core files
.openpublishing.publish.config.json Registers new redirection file
Comments suppressed due to low confidence (1)

docs/navigate/migration-guide/toc.yml:1

  • The removed troubleshooting entry has malformed query parameters with duplicate toc and bc parameters separated by ? instead of &. This would have caused incorrect URL resolution.
items:

Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This LGTM. You can :shipit: when you're ready.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants