Skip to content

Commit 9afb9a5

Browse files
Merge pull request #6088 from MicrosoftDocs/main
Auto Publish – main to live - 2025-12-05 21:52 UTC
2 parents 5565617 + 12d837c commit 9afb9a5

20 files changed

Lines changed: 670 additions & 439 deletions
569 KB
Loading

hub/apps/design/downloads/index.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,17 @@ The Design Guidance section of the WinUI Gallery offers best practices and tools
4444
> [!div class="button"]
4545
> [Design Guidance in WinUI Gallery](winui3gallery://item/Color)
4646
47+
## Microsoft Store Asset Guidance Kit
48+
49+
:::image type="content" source="images/store-asset-kit.png" alt-text="A cover image of the Microsoft Store Asset Guidance Kit":::
50+
51+
The Microsoft Store Asset Guidance Kit for Figma provides templates and tools to help create high-quality screenshots, app icons, and other assets for publishing on the Microsoft Store.
52+
53+
This kit supports the full process of creating, testing, and submitting app and game assets. It includes guidance for logo and icon sizing, along with previews that show how your icon will appear in the Store after submission to Partner Center. It also offers customizable templates to help produce consistent, polished screenshots for your app or game.
54+
55+
> [!div class="button"]
56+
> [Microsoft Store Asset Guidance Kit for Figma](https://www.figma.com/community/file/1568793421368412416)
57+
4758
## Samples
4859

4960
Check out the [Samples and resources page](https://developer.microsoft.com/windows/samples) for complete list of all our Windows app samples.

hub/apps/desktop/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ landingContent:
4141
- text: Make your apps great on Windows 11
4242
url: ../get-started/make-apps-great-for-windows.md
4343
- text: Windows developer FAQ
44-
url: ../get-started/windows-developer-faq.yml
44+
url: ../get-started/windows-developer-faq.md
4545

4646
- title: Deploy and publish
4747
linkLists:

hub/apps/get-started/best-practices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -297,5 +297,5 @@ Most modern apps collect and use a large amount of data – including personal d
297297
## Related articles
298298

299299
- [Create your first WinUI 3 project](../winui/winui3/create-your-first-winui3-app.md)
300-
- [Windows Developer FAQ](./windows-developer-faq.yml)
300+
- [Windows Developer FAQ](./windows-developer-faq.md)
301301
- [Things you can do to make your app great on Windows 11](./make-apps-great-for-windows.md)

hub/apps/get-started/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ WPF is a well-established framework for Windows desktop applications with access
6464
Additionally, you can now integrate a sandbox environment into your packaged WPF applications, providing an extra layer of security. This enhancement requires little to no change to your code, thanks to the new [Win32 App Isolation](https://github.com/microsoft/win32-app-isolation) security feature.
6565

6666
> [!TIP]
67-
> If you already invested in WPF, you can continue to use it and take advantage of the modernization options in .NET 9. You can build your apps knowing that Microsoft is continuing to invest in WPF. See the [Windows developer FAQ](windows-developer-faq.yml) for more information.
67+
> If you already invested in WPF, you can continue to use it and take advantage of the modernization options in .NET 9. You can build your apps knowing that Microsoft is continuing to invest in WPF. See the [Windows developer FAQ](windows-developer-faq.md) for more information.
6868
6969
> [!div class="button"]
7070
> [Get started with WPF](/dotnet/desktop/wpf/overview/)
@@ -229,7 +229,7 @@ You have many options for developing applications for Windows. The best option f
229229

230230
Learn more about each of these options:
231231

232-
- [Windows developer FAQ](windows-developer-faq.yml)
232+
- [Windows developer FAQ](windows-developer-faq.md)
233233
- [.NET Multi-platform App UI (.NET MAUI)](/dotnet/maui/)
234234
- [ASP.NET Core Blazor Hybrid](/aspnet/core/blazor/hybrid)
235235
- [React Native for Desktop](/windows/dev-environment/javascript/react-native-for-windows)

hub/apps/get-started/windows-developer-faq.md

Lines changed: 562 additions & 0 deletions
Large diffs are not rendered by default.

hub/apps/get-started/windows-developer-faq.yml

Lines changed: 0 additions & 364 deletions
This file was deleted.

hub/apps/get-started/windows-developer-glossary.md

Lines changed: 32 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Windows developer glossary
33
description: A glossary of terms related to Windows application development.
44
ms.topic: glossary
5-
ms.date: 11/25/2025
5+
ms.date: 12/05/2025
66
ms.localizationpriority: medium
77
ms.collection: windows11
88
audience: new-desktop-app-developers
@@ -11,31 +11,28 @@ content-type: glossary
1111

1212
# Windows developer glossary
1313

14-
The following glossary of terms is meant to promote a common vocabulary among Windows developers.
14+
This glossary promotes a common vocabulary among Windows developers.
1515

1616
#### App lifecycle management (ALM)
1717

18-
Describes the management of your application's execution state: not running, running in background, running in foreground, suspended, and so on. See [Windows 10 universal Windows platform (UWP) app lifecycle](/windows/uwp/launch-resume/app-lifecycle).
18+
Manage an application's execution state: not running, running in the background, running in the foreground, or suspended. See [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle).
1919

2020
#### Application model
2121

22-
Often referred to as "app model". The combination of deployment, isolation, lifecycle, and presentation components that are unique to a given application development technology. For example: Windows App SDK / WinUI 3 apps run on the Win32 app model, while UWP / WinUI 2 run on the UWP app model.
22+
Often referred to as "app model." The application model combines deployment, isolation, lifecycle, and presentation components that are unique to a given application development technology. For example, Windows App SDK and WinUI apps run on the Win32 app model, while WinUI for UWP apps run on the UWP app model.
2323

2424
#### Application packaging
2525

2626
Describes the way in which your app is packaged before being deployed and installed by users. An app can be packaged, unpackaged, or packaged with external location (see the [Windows developer FAQ](/windows/apps/get-started/windows-developer-faq#what-s-the-difference-between-apps-that-are-packaged--unpackaged--and-packaged-with-external-location)).
2727

28-
#### Azure AI Foundry
29-
30-
A managed platform for building, evaluating, and deploying generative AI applications with foundation models. Formerly known as Azure AI Studio. See [Azure AI Foundry documentation](/azure/ai-foundry/).
3128

3229
#### Bootstrapper
3330

34-
A redistributable component providing an API to find and load the Windows App SDK framework package for the calling process. In a packaged with external location or unpackaged app, you can opt to load the Windows App SDK framework package explicitly by calling Bootstrapper APIs such as [MddBootstrapInitialize](/windows/windows-app-sdk/api/win32/mddbootstrap/nf-mddbootstrap-mddbootstrapinitialize). Also see [Reference the Windows App SDK framework package at run time](../windows-app-sdk/use-windows-app-sdk-run-time.md).
31+
A redistributable component that provides an API to find and load the Windows App SDK framework package for the calling process. In a packaged-with-external-location or unpackaged app, you can load the Windows App SDK framework package explicitly by calling Bootstrapper APIs such as [MddBootstrapInitialize](/windows/windows-app-sdk/api/win32/mddbootstrap/nf-mddbootstrap-mddbootstrapinitialize). See [Reference the Windows App SDK framework package at run time](../windows-app-sdk/use-windows-app-sdk-run-time.md).
3532

3633
#### C++/WinRT
3734

38-
C++/WinRT is a standard C++17 language projection for Windows Runtime (WinRT) APIs, implemented as a header-file-based library, and designed to provide you with first-class access to modern Windows APIs. [C++/WinRT](/windows/uwp/cpp-and-winrt-apis/).
35+
C++/WinRT is a standard C++17 language projection for Windows Runtime (WinRT) APIs, implemented as a header-based library, and designed to provide first-class access to modern Windows APIs. See [C++/WinRT](/windows/uwp/cpp-and-winrt-apis/).
3936

4037
#### DirectML
4138

@@ -73,10 +70,18 @@ A transformer-based model trained on large corpora to understand and generate na
7370

7471
"Managed" refers to the "managed runtime" of .NET, which provides managed services such as garbage collection and security assurances. If you're building an app with .NET, you're building a managed app.
7572

73+
#### MCP Servers
74+
75+
MCP is an open protocol designed to standardize integrations between AI apps and external tools and data sources. [Model Context Protocol (MCP) Servers](/windows/ai/mcp/overview).
76+
7677
#### Microsoft Foundation Classes (MFC)
7778

7879
You can use Microsoft Foundation Classes (MFC) to create complex user interfaces with multiple controls. You can use MFC to create applications with Office-style user interfaces. See: [MFC desktop applications](/cpp/mfc/mfc-desktop-applications).
7980

81+
#### Microsoft Foundry
82+
83+
A managed platform for building, evaluating, and deploying generative AI applications with foundation models. Formerly Azure AI Foundry. See [Microsoft Foundry documentation](/azure/ai-foundry/).
84+
8085
#### MSIX (Microsoft Installer package format)
8186

8287
MSIX is a Windows app package format that combines the best features of MSI, .appx, App-V, and ClickOnce to provide a modern and reliable packaging experience. It's a modern application package format that lets you easily deploy your Windows applications. MSIX can be used to package apps built using Windows App SDK, Win32, WPF, or Windows Forms. When you use MSIX to deploy your apps, your app is a *packaged* app. A packaged app can check for updates, and can control when updates are applied. [What is MSIX?](/windows/msix/overview).
@@ -91,15 +96,11 @@ Traditionally, "native" refers to applications built without using the .NET runt
9196

9297
#### Neural Processing Unit (NPU)
9398

94-
A dedicated on‑device AI accelerator optimized for transformer operations and other ML workloads. Windows apps can target NPUs via APIs like [DirectML](/windows/ai/directml/dml-intro).
95-
96-
#### Text recognition
97-
98-
Text recognition, also known as optical character recognition (OCR), is supported by a set of Windows AI APIs that can detect and extract text within images and convert it into machine readable character streams. See [Get started with AI Text Recognition](/windows/ai/apis/text-recognition).
99+
A dedicated on‑device AI accelerator optimized for transformer operations and other ML workloads. Windows apps can target NPUs via APIs included as part of [Foundry Local](/windows/ai/foundry-local/get-started).
99100

100101
#### ONNX Runtime (ORT)
101102

102-
A high‑performance, cross‑platform inference engine for models in the ONNX format. On Windows, ORT commonly uses the DirectML execution provider for GPU/NPU acceleration. See [ONNX Runtime documentation](https://onnxruntime.ai/docs/). WindowsML uses ONNX Runtime under the hood.
103+
A high‑performance, cross‑platform inference engine for models in the ONNX format. See [Run ONNX models](/windows/ai/new-windows-ml/run-onnx-models).
103104

104105
#### Packaged app
105106

@@ -127,22 +128,26 @@ The codename for the Windows App SDK. No longer in use.
127128

128129
#### React Native for Desktop
129130

130-
[React Native for Desktop](https://aka.ms/reactnative) brings React Native support to the Windows 10 and Windows 11 SDKs, enabling developers to use JavaScript to build native Windows apps for all devices supported by Windows 10 and Windows 11. This includes PCs, tablets, 2-in-1s, Xbox, Mixed reality devices, etc. The term React Native for Desktop encompasses both React Native for Windows and React Native for macOS.
131+
[React Native for Desktop](https://aka.ms/reactnative) brings React Native support to the Windows SDKs, enabling developers to use JavaScript to build native Windows apps for devices supported by Windows 10 and Windows 11. This includes PCs, tablets, 2-in-1s, and Xbox. The term React Native for Desktop encompasses both React Native for Windows and React Native for macOS.
131132

132133
#### Responsible AI (RAI)
133134

134135
A set of recommended responsible development practices to use as you create applications and features. See [Developing Responsible Generative AI Applications and Features on Windows](/windows/ai/rai/) to learn more about the RAI principles and how they apply to Windows development.
135136

136137
#### Small language model (SLM)
137138

138-
A compact model (for example, Microsoft Phi‑3) designed to run efficiently on client devices (CPU/GPU/NPU) with lower latency and cost, suitable for many on‑device AI scenarios. See [Get started with Phi Silica](/windows/ai/apis/phi-silica).
139+
A compact model (for example, Microsoft Phi 3) designed to run efficiently on client devices (CPU, GPU, or NPU) with lower latency and cost, suitable for many on device AI scenarios. See [Get started with Phi Silica](/windows/ai/apis/phi-silica).
140+
141+
#### Text recognition
142+
143+
Text recognition, also known as optical character recognition (OCR), is supported by Windows AI APIs that detect and extract text within images and convert it into machine-readable character streams. See [Get started with AI Text Recognition](/windows/ai/apis/text-recognition).
139144

140145
#### Universal Windows Platform (UWP)
141146

142147
An application development platform and application model that uses Windows Runtime (WinRT) APIs to deliver packaged apps. UWP apps run in a sandboxed environment, and they inherit the security of the UWP platform. [Learn more about UWP](/windows/uwp/).
143148

144149
>[!NOTE]
145-
> The [preferred approach for writing Windows apps](/windows/apps/get-started/) is to use the Windows App SDK and [WinUI](/windows/apps/get-started/start-here). Another option is [WPF](/dotnet/desktop/wpf/getting-started).
150+
> Build Windows apps with [Windows App SDK and WinUI](/windows/apps/get-started/). You can also use [WPF](/dotnet/desktop/wpf/getting-started).
146151
147152
#### Unmanaged app
148153

@@ -158,19 +163,19 @@ Lets you create, package, and deploy Visual Studio extensions. [Get started with
158163

159164
#### WebView2
160165

161-
A control that allows app developers to embed web content (HTML/CSS/JS) in their native apps using the Microsoft Edge (Chromium) rendering engine. You can use WebView2 in WinUI 3, Win32 C++, WPF, and WinForms, and it offers a developer preview for WinUI 2 / UWP support. See [Introduction to Microsoft Edge WebView2](/microsoft-edge/webview2/).
166+
A control that allows app developers to embed web content (HTML/CSS/JS) in their native apps using the Microsoft Edge (Chromium) rendering engine. You can use WebView2 in WinUI, Win32 C++, WPF, and WinForms, and it offers a developer preview for WinUI for UWP support. See [Introduction to Microsoft Edge WebView2](/microsoft-edge/webview2/).
162167

163168
#### Microsoft Foundry on Windows
164169

165-
Microsoft Foundry on Windows offers AI-backed features and APIs on Windows 11 PCs. These features are in active development. See [What are Windows AI APIs?](/windows/ai/overview).
170+
Microsoft Foundry on Windows offers AI-backed features and APIs on Windows 11 PCs. These features are in active development. See [Windows AI APIs overview](/windows/ai/overview).
166171

167172
#### Windows API
168173

169174
Refers to the entire set of Windows APIs including Win32 APIs, COM APIs, UWP WinRT APIs, and the WinRT/Win32 APIs that are part of the Windows App SDK and WinUI.
170175

171176
#### Windows App SDK
172177

173-
A set of new developer components and tools that represent the next evolution in the Windows app development platform. The successor to UWP / WinUI 2 for desktop application development. It lifts libraries from the OS into a standalone SDK that you can use to build backwards-compatible desktop apps, and is often used to ship new features and capabilities. See [Overview of app development options](./index.md).
178+
A set of developer components and tools that represent the next evolution of the Windows app development platform. The successor to WinUI for UWP for desktop application development. It lifts libraries from the OS into a standalone SDK that you can use to build backward-compatible desktop apps and often ships new features and capabilities. See [Overview of app development options](./index.md).
174179

175180
#### Windows Forms
176181

@@ -184,23 +189,23 @@ A UI framework for building Windows desktop applications. WPF applications are b
184189

185190
The Windows SDK is a collection of headers, libraries, metadata, and tools that allow you to build desktop and UWP Windows apps. The Windows SDK is not the same as the [Windows App SDK](#windows-app-sdk).
186191

187-
#### WinUI 2
192+
#### WinUI (previously referred to as WinUI 3)
188193

189-
WinUI 2 is tightly integrated with Windows SDKs, and provides official native Windows UI controls and other user interface elements for UWP applications (and desktop applications using XAML Islands). See [WinUI 2](/windows/uwp/get-started/winui2/).
194+
The latest and recommended UI framework for Windows desktop apps. This framework is made available through the Windows App SDK, and has been decoupled from the Windows operating system. WinUI uses [Fluent Design](https://aka.ms/fluent) to provide a native UX framework for Windows desktop apps. It will feel very familiar if you've worked with WinUI for UWP. Note that WinUI apps are commonly referred to as "WinUI apps". See [WinUI](../winui/winui3/index.md).
190195

191-
#### WinUI (previously referred to as WinUI 3)
196+
#### WinUI for UWP (previously referred to as WinUI 2)
192197

193-
The latest and recommended UI framework for Windows desktop apps. This framework is made available through the Windows App SDK, and has been decoupled from the Windows operating system. WinUI uses [Fluent Design](https://aka.ms/fluent) to provide a native UX framework for Windows desktop apps. It will feel very familiar if you've worked with WinUI 2. Note that WinUI apps are commonly referred to as "WinUI apps". See [WinUI](../winui/winui3/index.md).
198+
WinUI for UWP is tightly integrated with Windows SDKs and provides native Windows UI controls and other user interface elements for UWP applications and desktop applications using XAML Islands. See [WinUI for UWP](/windows/uwp/get-started/winui2/).
194199

195200
#### XAML Islands
196201

197202
XAML Islands lets you host WinRT XAML controls in non-UWP desktop (Win32, WinForms, WPF) apps starting in Windows 10, version 1903. [Host WinRT XAML controls in desktop apps (XAML Islands)](../desktop/modernize/xaml-islands/xaml-islands.md).
198203

199204
#### Windows ML
200205

201-
Windows APIs for running ONNX models locally in Windows apps, with hardware acceleration via DirectML where available. See [Windows ML](/windows/ai/windows-ml/).
206+
Windows APIs for running ONNX models locally in Windows apps, with hardware acceleration via DirectML where it's available. See [Windows ML](/windows/ai/new-windows-ml/overview).
202207

203208
## Related content
204209

205-
- [Windows developer FAQ](windows-developer-faq.yml)
210+
- [Windows developer FAQ](windows-developer-faq.md)
206211
- [Overview of app development options](./index.md)

hub/apps/how-tos/copilot-chat-winui3.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -254,5 +254,5 @@ In this how-to, we:
254254
## Related content
255255

256256
- [Sample applications for Windows development](../get-started/samples.md)
257-
- [Windows developer FAQ](../get-started/windows-developer-faq.yml)
257+
- [Windows developer FAQ](../get-started/windows-developer-faq.md)
258258
- [Windows development best practices](../get-started/best-practices.md)

hub/apps/how-tos/github-copilot-winui-vs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,5 +78,5 @@ In this how-to, we demonstrated how to use GitHub Copilot in Visual Studio to as
7878
## Related content
7979

8080
- [Sample applications for Windows development](../get-started/samples.md)
81-
- [Windows developer FAQ](../get-started/windows-developer-faq.yml)
81+
- [Windows developer FAQ](../get-started/windows-developer-faq.md)
8282
- [Windows development best practices](../get-started/best-practices.md)

0 commit comments

Comments
 (0)