Skip to content

Commit cd0f38e

Browse files
GrantMeStrengthniels9001Copilot
authored
Consolidating AI docs and updating landingspage and ToC (#6646)
* Merge community page into support, remove common dev topics Moved social media, blogs, videos, and Discord from community.md into support.md under a new Stay connected section. Removed the Common development topics section (duplicated content from the main TOC). Deleted community.md with redirect. Updated TOC to combine the entries as 'Support and community'. Co-authored-by: Copilot <[email protected]> * Push * Remove duplicate AI overview page, redirect to agentic-tools Deleted ai-for-windows-developers.md — its AI coding tools content duplicated agentic-tools.md. Updated TOC to point to agentic-tools as the section landing page. Added redirect. Co-authored-by: Copilot <[email protected]> * Push * Update apps-essentials-overview.md * Push * Push * Update index.yml * Fixes * Update toc.yml * Update toc.yml * Update apps-essentials-overview.md * Update toc.yml * Add ai-modernize row to migration overview and nest agentic tutorials in TOC - Added ai-modernize.md row to the Topics table in migrate-to-windows-app-sdk-ovw.md - Restructured Agentic tools TOC: tutorials now nested under a Tutorials sub-item Co-authored-by: Copilot <[email protected]> --------- Co-authored-by: Niels Laute <[email protected]> Co-authored-by: Copilot <[email protected]>
1 parent 3c90c06 commit cd0f38e

21 files changed

Lines changed: 178 additions & 555 deletions

.openpublishing.redirection.json

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11420,6 +11420,36 @@
1142011420
"redirect_url": "/windows/apps/dev-tools/visual-studio",
1142111421
"redirect_document_id": false
1142211422
},
11423+
{
11424+
"source_path": "hub/apps/whats-new/community.md",
11425+
"redirect_url": "/windows/apps/develop/support#stay-connected",
11426+
"redirect_document_id": false
11427+
},
11428+
{
11429+
"source_path": "hub/apps/get-started/ai-for-windows-developers.md",
11430+
"redirect_url": "/windows/apps/dev-tools/agentic-tools",
11431+
"redirect_document_id": false
11432+
},
11433+
{
11434+
"source_path": "hub/apps/how-tos/github-copilot-winui-vs.md",
11435+
"redirect_url": "/windows/apps/how-tos/ai-build",
11436+
"redirect_document_id": false
11437+
},
11438+
{
11439+
"source_path": "hub/apps/get-started/ai-build.md",
11440+
"redirect_url": "/windows/apps/how-tos/ai-build",
11441+
"redirect_document_id": false
11442+
},
11443+
{
11444+
"source_path": "hub/apps/get-started/ai-setup.md",
11445+
"redirect_url": "/windows/apps/how-tos/ai-setup",
11446+
"redirect_document_id": false
11447+
},
11448+
{
11449+
"source_path": "hub/apps/get-started/samples.md",
11450+
"redirect_url": "/windows/apps/dev-tools/samples",
11451+
"redirect_document_id": false
11452+
},
1142311453
{
1142411454
"source_path": "hub/apps/design/accessibility/accessibility.md",
1142511455
"redirect_url": "/windows/apps/design/accessibility/accessibility-overview",

hub/apps/desktop/index.yml

Lines changed: 58 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -8,114 +8,95 @@ metadata:
88
description: This documentation provides the latest guidance about building desktop apps for Windows 11.
99
ms.topic: landing-page
1010
ms.collection: collection
11-
ms.date: 11/25/2025
11+
ms.date: 03/27/2026
1212
keywords: windows win32, desktop development
1313

1414
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
1515

1616
landingContent:
17-
- title: Get ready for development
17+
- title: Essentials
1818
linkLists:
1919
- linkListType: get-started
2020
links:
21-
- text: What's new in Windows development
22-
url: /windows/apps/whats-new/whats-new-for-developers
23-
- text: Setup and tools
24-
url: ../get-started/start-here.md
25-
- text: An overview of UI frameworks
21+
- text: Essentials
22+
url: ../introduction.md
23+
- text: Core concepts
2624
url: ../get-started/index.md
27-
- text: Windows App SDK
28-
url: ../windows-app-sdk/index.md
25+
- text: Get started with WinUI
26+
url: ../get-started/start-here.md
27+
- text: Tools and samples
28+
url: ../dev-tools/index.md
29+
- text: Help and guidance
30+
url: ../develop/support.md
31+
- text: What's new
32+
url: ../whats-new/whats-new-for-developers.md
2933

30-
- title: Design and UI
34+
- title: Design
3135
linkLists:
3236
- linkListType: overview
3337
links:
34-
- text: Design your app
38+
- text: Design overview
3539
url: ../design/index.md
36-
- text: Design resources and tools
40+
- text: Design principles
41+
url: ../design/design-principles.md
42+
- text: Guidelines
43+
url: ../design/guidelines-overview.md
44+
- text: Tools and resources
3745
url: ../design/downloads/index.md
38-
- text: Design for accessibility
39-
url: ../design/accessibility/accessibility.md
40-
- text: Design basics
41-
url: ../design/basics/index.md
4246

4347
- title: Develop
4448
linkLists:
4549
- linkListType: how-to-guide
4650
links:
47-
- text: Develop apps
51+
- text: Develop overview
4852
url: ../develop/index.md
49-
- text: Best practices for Windows apps
50-
url: ../get-started/best-practices.md
51-
- text: Windows developer FAQ
52-
url: ../get-started/windows-developer-faq.md
53-
- text: Other development tools
54-
url: /windows/dev-environment/
53+
- text: Features
54+
url: ../develop/features-overview.md
55+
- text: Use features with other UI frameworks
56+
url: ../desktop/modernize/index.md
57+
- text: Platform
58+
url: ../develop/platform/csharp-winrt/index.md
59+
- text: API reference
60+
url: ../api-reference/index.md
61+
- text: Tools and samples
62+
url: ../dev-tools/index.md
63+
- text: Tutorials
64+
url: ../winui/winui3/desktop-winui3-app-with-basic-interop.md
5565

56-
- title: Deploy
66+
- title: Package and deploy
5767
linkLists:
58-
- linkListType: overview
68+
- linkListType: deploy
5969
links:
60-
- text: Packaging and deployment overview
70+
- text: Package and deploy overview
6171
url: ../package-and-deploy/index.md
62-
- text: Learn about packaged and unpackaged apps
63-
url: ../desktop/modernize/package-identity-overview.md
64-
- text: Windows App SDK deployment guide
72+
- text: Choose a packaging model
73+
url: ../package-and-deploy/choose-packaging-model.md
74+
- text: Packaging
75+
url: ../package-and-deploy/packaging/index.md
76+
- text: Windows App SDK deployment
6577
url: ../package-and-deploy/deploy-overview.md
66-
- text: The MSIX app package format
67-
url: /windows/msix
6878

6979
- title: Distribute
7080
linkLists:
7181
- linkListType: overview
7282
links:
73-
- text: Microsoft Store overview
83+
- text: Publish overview
7484
url: ../publish/index.md
85+
- text: Get started with Microsoft Store
86+
url: ../publish/get-started.md
7587
- text: Open a developer account
7688
url: ../publish/partner-center/open-a-developer-account.md
77-
- text: Microsoft Store FAQ
78-
url: ../publish/faq/get-started-with-the-microsoft-store.md
79-
- text: Microsoft Store Policies
80-
url: ../publish/store-policies.md
81-
82-
- title: Artificial intelligence and machine learning
83-
linkLists:
84-
- linkListType: concept
85-
links:
86-
- text: Windows AI
87-
url: /windows/ai/
88-
- text: GitHub Copilot extension for Visual Studio
89-
url: /visualstudio/ide/visual-studio-github-copilot-extension
90-
- text: App Actions on Windows
91-
url: /windows/ai/app-actions/
92-
- text: Windows ML
93-
url: /windows/ai/new-windows-ml/overview
94-
95-
- title: API Reference
96-
linkLists:
97-
- linkListType: reference
98-
links:
99-
- text: WinRT API for the Windows SDK
100-
url: /uwp/api/
101-
- text: Win32 API for the Windows SDK
102-
url: /windows/win32/api/
103-
- text: WinRT API for the Windows App SDK
104-
url: /windows/windows-app-sdk/api/winrt/
105-
- text: Win32 API for the Windows App SDK
106-
url: /windows/windows-app-sdk/api/win32/
107-
- text: WinUI for UWP API reference
108-
url: /windows/winui/api/
109-
110-
- title: Community and support
111-
linkLists:
112-
- linkListType: overview
113-
links:
114-
- text: Microsoft Q&A Forum
115-
url: /answers/questions/
116-
- text: "@WindowsDocs"
117-
url: https://twitter.com/WindowsDocs
118-
- text: OneDevMinute on Microsoft Learn
119-
url: /shows/One-Dev-Minute/?WT.mc_id=odm-c9-niner
120-
- text: Windows developer support
121-
url: https://developer.microsoft.com/windows/support
89+
- text: Submit your app
90+
url: ../publish/publish-your-app/msix/reserve-your-apps-name.md
91+
- text: Get your app certified
92+
url: ../publish/publish-your-app/msix/app-certification-process.md
93+
- text: Monitor your app performance
94+
url: ../publish/analyze-app-performance/msix.md
95+
- text: Manage and update your app
96+
url: ../publish/publish-your-app/msix/publish-update-to-your-app-on-store.md
97+
- text: Leverage developer tools
98+
url: ../publish/product-page-experiments.md
99+
- text: Manage your account
100+
url: ../publish/partner-center/manage-account-users.md
101+
- text: Microsoft Store policies and resources
102+
url: ../publish/store-policies.md

hub/apps/dev-tools/agentic-tools.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -68,11 +68,9 @@ The WinUI 3 plugin addresses this directly: its custom instructions give Copilot
6868

6969
## Set up step-by-step
7070

71-
For a complete walkthrough — including IDE setup, agent mode, MCP server configuration, and verification — see [Set up GitHub Copilot for Windows development](../get-started/ai-setup.md).
71+
For a complete walkthrough — including IDE setup, agent mode, MCP server configuration, and verification — see [Set up GitHub Copilot for Windows development](../how-tos/ai-setup.md).
7272

7373
## Related content
7474

75-
- [Set up GitHub Copilot for Windows development](../get-started/ai-setup.md)
76-
- [AI-assisted Windows development](../get-started/ai-for-windows-developers.md)
77-
- [Build apps with AI built in](../get-started/ai-for-windows-developers.md#build-apps-with-ai-built-in) — Foundry Local, Phi Silica, and Windows AI APIs
78-
- [GitHub Copilot in Visual Studio](../how-tos/github-copilot-winui-vs.md)
75+
- [Set up GitHub Copilot for Windows development](../how-tos/ai-setup.md)
76+
- [Tutorial: Build a Windows app with GitHub Copilot](../how-tos/ai-build.md)

hub/apps/dev-tools/index.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: Tools and samples for Windows app development
3+
description: Explore tools, samples, and AI-powered resources for building Windows apps, including Visual Studio, agentic AI tools, code samples, and the winapp CLI.
4+
ms.topic: overview
5+
ms.date: 03/27/2026
6+
---
7+
8+
# Tools and samples for Windows app development
9+
10+
Build Windows apps more efficiently with the right tools, samples, and AI-powered resources. Whether you're setting up your development environment, looking for sample code to learn from, or enhancing your AI coding agent with Windows-specific context, this section brings together everything you need to be productive as a Windows app developer.
11+
12+
| Resource | Description |
13+
|---|---|
14+
| [Agentic AI tools](agentic-tools.md) | Enhance your AI coding agent with Windows-specific context using the Microsoft Learn MCP Server and community plugins like the WinUI 3 Development plugin for GitHub Copilot. |
15+
| [Code samples](samples.md) | Browse sample apps that demonstrate Windows features, API usage patterns, and end-to-end scenarios — including the WinUI 3 Gallery and Windows App SDK samples. |
16+
| [Visual Studio](visual-studio.md) | The recommended IDE for building Windows apps with WinUI and the Windows App SDK, featuring XAML Hot Reload, Live Visual Tree, and rich debugging. |
17+
| [Windows App Development CLI (winapp CLI)](winapp-cli/index.md) | A command-line interface for managing Windows SDKs, packaging, app identity, manifests, certificates, and build tools across any app framework. |
Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ This page contains links to resources that can make you more efficient as you de
1515

1616
## Samples
1717

18-
:::image type="content" source="./images/WASDK.png" alt-text="Header image for Windows App SDK" border="false":::
18+
:::image type="content" source="../get-started/images/WASDK.png" alt-text="Header image for Windows App SDK" border="false":::
1919

2020
The [**WindowsAppSDK-Samples repository**](https://github.com/microsoft/WindowsAppSDK-Samples) provides a collection of code samples that demonstrate how to use the Windows App SDK to build modern Windows applications. These samples cover key features such as WinUI 3, app lifecycle, windowing, and push notifications, offering practical, hands-on guidance for developers. Whether you're new to the Windows App SDK or looking for specific implementation details, this repository serves as a valuable resource to accelerate development and explore best practices. You can find other samples in our [Samples Browser](/samples/browse/).
2121

@@ -25,7 +25,7 @@ The [**WindowsAppSDK-Samples repository**](https://github.com/microsoft/WindowsA
2525
2626
## WinUI 3 Gallery
2727

28-
:::image type="content" source="./images/winui3gallery.png" alt-text="Header image for WinUI 3 Gallery" border="false":::
28+
:::image type="content" source="../get-started/images/winui3gallery.png" alt-text="Header image for WinUI 3 Gallery" border="false":::
2929

3030
The [**WinUI 3 Gallery**](https://github.com/microsoft/WinUI-Gallery) is the must-have companion app for WinUI developers. It's a sample app that showcases the full range of WinUI controls, styles, design guidance, and capabilities. This interactive gallery helps you explore and experiment with WinUI components, view XAML code examples, and understand best practices for building modern, fluent Windows applications. Whether you're designing a new app or refining an existing UI, the WinUI 3 Gallery is an essential reference for leveraging the power of WinUI in your projects. You can either [browse the repository](https://github.com/microsoft/WinUI-Gallery) for source code or [**download the WinUI 3 Gallery from the Microsoft Store**](https://aka.ms/winuigallery).
3131

@@ -35,7 +35,7 @@ The [**WinUI 3 Gallery**](https://github.com/microsoft/WinUI-Gallery) is the mus
3535
3636
## Windows Community Toolkit
3737

38-
:::image type="content" source="./images/WCT.png" alt-text="Header image for Windows Community Toolkit" border="false":::
38+
:::image type="content" source="../get-started/images/WCT.png" alt-text="Header image for Windows Community Toolkit" border="false":::
3939

4040
The [**Windows Community Toolkit**](https://github.com/CommunityToolkit/Windows) is an open-source collection of helper functions, custom controls, and app services. It simplifies and demonstrates common developer tasks when building apps for Windows.
4141

0 commit comments

Comments
 (0)