Skip to content

Commit 4505845

Browse files
Move ai-modernize.md to migration section; trim duplication in ai-for-windows-devs.md
- Moved hub/apps/get-started/ai-modernize.md to hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/ai-modernize.md per reviewer suggestion that the content fits the migration section better - Updated all relative links inside the moved file - Added entry to develop/toc.yml under 'Migrate from UWP' section - Removed entry from hub/apps/toc.yml get-started section - Trimmed duplicate tool descriptions in ai-for-windows-devs.md; replaced with single paragraph linking to agentic-tools.md - Updated ai-for-windows-devs.md Next steps link to new file location Co-authored-by: Copilot <[email protected]>
1 parent 75323f9 commit 4505845

4 files changed

Lines changed: 15 additions & 24 deletions

File tree

hub/apps/develop/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -898,6 +898,8 @@ items:
898898
href: ../windows-app-sdk/migrate-to-windows-app-sdk/case-study-2.md
899899
- name: Additional migration guidance
900900
href: ../windows-app-sdk/migrate-to-windows-app-sdk/misc-info.md
901+
- name: Modernize or port a Windows app with GitHub Copilot
902+
href: ../windows-app-sdk/migrate-to-windows-app-sdk/ai-modernize.md
901903
- name: Migrate UWP to Windows App SDK with the .NET Upgrade Assistant
902904
href: ../windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant.md
903905
- name: Use MSIX framework packages

hub/apps/get-started/ai-for-windows-devs.md

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -23,19 +23,9 @@ This article introduces the tools and what they make possible. When you're ready
2323

2424
For Windows developers, the key is giving Copilot accurate Windows-specific knowledge. Out of the box, Copilot knows a lot about general C# and .NET — but it can struggle with WinUI 3 specifics, confusing newer APIs with deprecated UWP equivalents. The tools below fix that.
2525

26-
### WinUI 3 development plugin
26+
### WinUI 3 development plugin and Microsoft Learn MCP Server
2727

28-
The [WinUI 3 development plugin](../dev-tools/agentic-tools.md#winui-3-development-plugin-for-github-copilot) for GitHub Copilot teaches Copilot the right modern Windows App SDK patterns. It includes:
29-
30-
- A **WinUI 3 Expert agent** that knows current API namespaces, XAML controls, MVVM patterns, and app lifecycle
31-
- A **migration guide skill** (`/winui3-development:winui3-migration-guide`) that maps UWP APIs to their WinUI 3 equivalents with before/after code samples
32-
- **Custom instructions** applied to your XAML and C# files that prevent the most common mistakes, like using `CoreDispatcher` instead of `DispatcherQueue`
33-
34-
### Microsoft Learn MCP Server
35-
36-
The [Microsoft Learn MCP Server](../dev-tools/agentic-tools.md#microsoft-learn-mcp-server) gives Copilot live access to official Microsoft documentation. Instead of relying on training data that may be out of date, Copilot can look up the latest API references, code samples, and release notes as it helps you code.
37-
38-
Add one endpoint to your IDE config and Copilot can answer questions like *"What's the WinUI 3 API for showing a file picker?"* with accurate, current answers.
28+
Two tools give Copilot the Windows-specific context it needs: the **WinUI 3 development plugin** (which teaches Copilot correct modern API patterns) and the **Microsoft Learn MCP Server** (which gives Copilot live access to official documentation). Full details and setup are in [Agentic AI tools for Windows development](../dev-tools/agentic-tools.md).
3929

4030
### Windows App Development CLI (winapp CLI)
4131

@@ -91,5 +81,5 @@ Electron, Flutter, React Native, and Rust developers can use Copilot to adapt th
9181
Or jump straight to:
9282

9383
- [Tutorial: Build a Windows app with GitHub Copilot](ai-build.md)
94-
- [Modernize or port a Windows app with Copilot](ai-modernize.md)
84+
- [Modernize or port a Windows app with Copilot](../windows-app-sdk/migrate-to-windows-app-sdk/ai-modernize.md)
9585
- [Agentic AI tools for Windows development](../dev-tools/agentic-tools.md)

hub/apps/toc.yml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -96,8 +96,7 @@ items:
9696
href: get-started/ai-setup.md
9797
- name: "Tutorial: Build a Windows app with GitHub Copilot"
9898
href: get-started/ai-build.md
99-
- name: Modernize or port a Windows app with Copilot
100-
href: get-started/ai-modernize.md
99+
101100
- name: Samples and resources
102101
items:
103102
- name: Samples

hub/apps/get-started/ai-modernize.md renamed to hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/ai-modernize.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Make sure you have the key tools configured:
2121
- **Microsoft Learn MCP Server** — gives Copilot access to current Windows App SDK documentation
2222
- **winapp CLI** — adds package identity and Windows packaging to any framework
2323

24-
If you haven't set these up yet, start with [Set up GitHub Copilot for Windows development](ai-setup.md).
24+
If you haven't set these up yet, start with [Set up GitHub Copilot for Windows development](../../get-started/ai-setup.md).
2525

2626
---
2727

@@ -107,7 +107,7 @@ Ask Copilot to walk you through it:
107107

108108
## Add Windows features to a cross-platform app
109109

110-
Electron, Flutter, React Native, and Rust apps can all become first-class Windows citizens with [winapp CLI](../dev-tools/winapp-cli/index.md). Copilot helps you adapt your code for Windows APIs once you have package identity.
110+
Electron, Flutter, React Native, and Rust apps can all become first-class Windows citizens with [winapp CLI](../../dev-tools/winapp-cli/index.md). Copilot helps you adapt your code for Windows APIs once you have package identity.
111111

112112
### Electron
113113

@@ -121,7 +121,7 @@ Once the addon is scaffolded, ask Copilot to integrate it:
121121

122122
> *"I've scaffolded a Windows notifications addon for my Electron app using winapp CLI. Show me how to send a notification from the main process when a download completes."*
123123
124-
For a complete walkthrough, see the [Electron setup guide](../dev-tools/winapp-cli/guides/electron-setup.md).
124+
For a complete walkthrough, see the [Electron setup guide](../../dev-tools/winapp-cli/guides/electron-setup.md).
125125

126126
### Flutter
127127

@@ -131,19 +131,19 @@ winapp init
131131

132132
> *"I have a Flutter app for Windows. Show me how to use the Windows App SDK to add a system tray icon with a context menu."*
133133
134-
See the [Flutter guide](../dev-tools/winapp-cli/guides/flutter.md) for Windows-specific setup.
134+
See the [Flutter guide](../../dev-tools/winapp-cli/guides/flutter.md) for Windows-specific setup.
135135

136136
### WPF / .NET
137137

138138
> *"I have a WPF app. Walk me through using winapp CLI to add MSIX packaging and then add an on-device AI feature using the Windows AI APIs."*
139139
140-
See the [.NET guide](../dev-tools/winapp-cli/guides/dotnet.md).
140+
See the [.NET guide](../../dev-tools/winapp-cli/guides/dotnet.md).
141141

142142
---
143143

144144
## What gets unlocked by package identity
145145

146-
Many powerful Windows features require [package identity](../dev-tools/winapp-cli/index.md#why-package-identity) — which winapp CLI can add to any framework. Once you have it, Copilot can help you use:
146+
Many powerful Windows features require [package identity](../../dev-tools/winapp-cli/index.md#why-package-identity) — which winapp CLI can add to any framework. Once you have it, Copilot can help you use:
147147

148148
| Feature | What to ask Copilot |
149149
|---|---|
@@ -157,7 +157,7 @@ Many powerful Windows features require [package identity](../dev-tools/winapp-cl
157157

158158
## Next steps
159159

160-
- [Agentic AI tools for Windows development](../dev-tools/agentic-tools.md) — full details on the WinUI 3 plugin and Learn MCP Server
161-
- [Windows App Development CLI (winapp CLI)](../dev-tools/winapp-cli/index.md) — full reference for adding Windows features to any framework
162-
- [Windows App SDK documentation](../windows-app-sdk/index.md)
160+
- [Agentic AI tools for Windows development](../../dev-tools/agentic-tools.md) — full details on the WinUI 3 plugin and Learn MCP Server
161+
- [Windows App Development CLI (winapp CLI)](../../dev-tools/winapp-cli/index.md) — full reference for adding Windows features to any framework
162+
- [Windows App SDK documentation](../index.md)
163163
- [Windows AI APIs](/windows/ai/) — on-device AI features available once you have package identity

0 commit comments

Comments
 (0)