Skip to content

Commit b6ecd81

Browse files
Qiutong ShenCopilot
andcommitted
Fix: Glossary, FAQ, and best practices content updates
Glossary (windows-developer-glossary.md): - Fix broken anchor link in Application Packaging FAQ reference - Update Microsoft Foundry description: Windows 10 and later (not Windows 11 only) - Update NPU entry: mention all three access pathways (Windows AI APIs, Foundry Local, Windows ML EPs) - Update Windows ML description: automatic EP management across CPUs/GPUs/NPUs - Remove outdated WebView2 UWP developer preview mention - Add Windows App SDK lifecycle reference to ALM definition FAQ (windows-developer-faq.md): - Fix XAML Islands link and update description (in development -> enables hosting) - Fix broken anchor in feature comparison table link - Fix 'Sample and resources' -> 'Samples and resources' typo Best practices (best-practices.md): - Fix broken Windows ML link (/windows/ai/windows-ml/ -> /windows/ai/new-windows-ml/overview) Co-authored-by: Copilot <[email protected]>
1 parent 429d5e7 commit b6ecd81

3 files changed

Lines changed: 10 additions & 10 deletions

File tree

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -240,7 +240,7 @@ You can build, package, and deliver Windows apps in many ways. The best practice
240240
People run Windows across conventional devices as well as an increasingly diverse, modern range of devices. Devices today come not only with x86/x64-based, but also Arm-based, architectures; not only with mouse and keyboard but also touch screens, touchpads, and pens; with cameras, GPS, and sensors like gyroscopes; and with graphics and neural processing chipsets that enable not only amazing visuals but also hardware-accelerated artificial intelligence (AI). Customers expect apps to take advantage of the hardware (that they have paid for!) and be cognizant of the device form factor to give them an appropriately optimized experience.
241241

242242
- Support a variety of inputs and interactions - [Input and interactions overview](../develop/input/index.md)
243-
- Achieve AI powered productivity with Win ML - [Introduction to Windows Machine Learning](/windows/ai/windows-ml/).
243+
- Achieve AI powered productivity with Win ML - [Introduction to Windows Machine Learning](/windows/ai/new-windows-ml/overview).
244244
- Use AI models that run locally and power Microsoft Foundry on Windows features on Copilot+ PCs - [What is Windows ML?](/windows/ai/apis/).
245245
- Use a variety of AI-powered features supported by Windows AI APIs in the Windows App SDK and machine learning (ML) models that run locally on Copilot+ PCs - [What are Windows AI APIs?](/windows/ai/apis/).
246246

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ Topics covered include:
8585

8686
> Note that [WinUI](../winui/winui3/index.md) (a UI framework) ships with the [Windows App SDK](../windows-app-sdk/index.md) (a Windows platform development framework).
8787
>
88-
> Generally, WinUI can't be used unless the app is ready to migrate its UI framework entirely. A feature called [XAML islands](/windows/apps/windows-app-sdk/stable-channel#xaml-islands-no-longer-experimental) is in development to host WinUI content in other UI frameworks (WPF, Win32).
88+
> Generally, WinUI can't be used unless the app is ready to migrate its UI framework entirely. A feature called [XAML Islands](../desktop/modernize/xaml-islands/xaml-islands.md) enables hosting WinUI content in other UI frameworks (WPF, Win32). See [XAML Islands documentation](../desktop/modernize/xaml-islands/xaml-islands.md) for more info.
8989
>
9090
> Elements of the Windows App SDK can often be used in desktop apps, depending on how the existing app was built. UWP apps are not supported by Windows App SDK.
9191
>
@@ -221,7 +221,7 @@ Topics covered include:
221221

222222
<details><summary>Where can I find WinUI samples?</summary>
223223

224-
> See [Sample and resources](./samples.md). Some notable repositories:
224+
> See [Samples and resources](./samples.md). Some notable repositories:
225225
>
226226
> - [WindowsAppSDK-Samples](https://github.com/microsoft/WindowsAppSDK-Samples): Demonstrates how to use specific Windows App SDK API sets.
227227
> - [Windows topic-specific samples](https://github.com/MicrosoftDocs/windows-topic-specific-samples/tree/winui-3/tutorials/winui-notes): Contains a WinUI notes sample used in the [Create a WinUI app](/windows/apps/tutorials/winui-notes/) tutorial.
@@ -389,7 +389,7 @@ Topics covered include:
389389
> - What languages or skills do you already have — .NET, JavaScript, something else?
390390
> - Do you need access to Windows-specific APIs?
391391
> - Which framework’s capabilities best match your app’s requirements?
392-
> - See [this table](/windows/apps/get-started/#app-development-framework-feature-comparison) for additional comparison factors.
392+
> - See [this table](/windows/apps/get-started/) for additional comparison factors.
393393
>
394394
> For many business apps, teams often choose based on existing skills and what the team is most comfortable using.
395395

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

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,15 +15,15 @@ This glossary promotes a common vocabulary among Windows developers.
1515

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

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).
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) and [Windows App SDK app lifecycle](../windows-app-sdk/applifecycle/applifecycle.md).
1919

2020
#### Application model
2121

2222
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 3 apps run on the Win32 app model, while WinUI for UWP apps run on the UWP app model.
2323

2424
#### Application packaging
2525

26-
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)).
26+
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)).
2727

2828

2929
#### Bootstrapper
@@ -96,7 +96,7 @@ Traditionally, "native" refers to applications built without using the .NET runt
9696

9797
#### Neural Processing Unit (NPU)
9898

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).
99+
A dedicated on‑device AI accelerator optimized for transformer operations and other ML workloads. Windows apps can target NPUs via [Windows AI APIs](/windows/ai/apis/), [Foundry Local](/windows/ai/foundry-local/get-started), or [Windows ML execution providers](/windows/ai/new-windows-ml/supported-execution-providers).
100100

101101
#### ONNX Runtime (ORT)
102102

@@ -163,11 +163,11 @@ Lets you create, package, and deploy Visual Studio extensions. [Get started with
163163

164164
#### WebView2
165165

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/).
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. See [Introduction to Microsoft Edge WebView2](/microsoft-edge/webview2/).
167167

168168
#### Microsoft Foundry on Windows
169169

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).
170+
Microsoft Foundry on Windows offers AI-backed features and APIs on Windows 10 and later PCs. Some features like Phi Silica require Copilot+ PC hardware. See [Windows AI APIs overview](/windows/ai/overview).
171171

172172
#### Windows API
173173

@@ -203,7 +203,7 @@ XAML Islands lets you host WinRT XAML controls in non-UWP desktop (Win32, WinFor
203203

204204
#### Windows ML
205205

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).
206+
Windows APIs for running ONNX models locally in Windows apps, with automatic execution provider management across CPUs, GPUs, and NPUs. See [Windows ML](/windows/ai/new-windows-ml/overview).
207207

208208
## Related content
209209

0 commit comments

Comments
 (0)