How to upgrade with GitHub Copilot

[mikadumont]

Proposed topic or title

How to upgrade with GitHub Copilot

Location in table of contents.

No response

Reason for the article

The GitHub Copilot modernization user guide is incomplete. The documentation would benefit from improved structure, deeper explanations, and more actionable examples to help users understand how to use the tool effectively. The article should include best practices, built in skills, customization, and troubleshooting guide.

Article abstract

This article outlines end‑to‑end upgrade examples, explanations of core concepts, and troubleshooting guidance. By strengthening foundational sections, expanding scenario walkthroughs, enhancing customization guidance, and improving cross‑navigation, the documentation can better support developers modernizing .NET applications. These improvements aim to reduce friction, increase upgrade success rates, and align the user guide with real‑world developer workflows.

Relevant searches

No response

---

Associated WorkItem - 564184

[adegeo]

The area should contain more articles about key concepts:

• Best practices: Practical advice about how to work with the agent
  This may be redundant with the "Working with the agent" article, perhaps merge?
• Built in skills: Details the skills built into the agent and scenarios they support. This gets you the best experience when your upgrade scenario is backed by skills.
• Customization: How to customize the agent with skills and edits to the files created by the process.
• Troubleshooting Guide: Details the common problems a user runs into and how to fix them.
• Working with the agent: Describes how the agent thinks and processes things, and details how you work with it to get the best possible results.

What specific How to guides should we have? These guides are defined as:

How-to articles help you complete a specific task from start to finish. When you're done reading, you've accomplished something concrete.

These articles are mostly procedural — steps organized into sections. But sections can also include alternative or optional steps to cover different situations. Unlike tutorials, how-to articles don't assume you need to follow every step exactly. Skip what doesn't apply to your scenario.

• How to upgrade a .NET app: Basic flow of how to start and complete an upgrade.
• How to apply custom upgrade instructions
  I don't know if this article should exist anymore as a "how to" guide. It's probably going to be covered in the Customization conceptual article