Merge pull request #6383 from MicrosoftDocs/main

Auto Publish – main to live - 2026-03-06 05:00 UTC

Author: learn-build-service-prod[bot]

.openpublishing.redirection.json

@@ -5955,6 +5955,11 @@
       "redirect_url": "/windows/apps/get-started/start-here",
       "redirect_document_id": false
     },
+    {
+      "source_path": "hub/apps/get-started/developer-mode-features-and-debugging.md",
+      "redirect_url": "/windows/advanced-settings/developer-mode",
+      "redirect_document_id": false
+    },
     {
       "source_path": "hub/apps/project-reunion/index.md",
       "redirect_url": "/windows/apps/windows-app-sdk/index",
@@ -10904,6 +10909,31 @@
       "source_path": "hub/apps/windows-app-sdk/system-requirements.md",
       "redirect_url": "/windows/apps/windows-app-sdk",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/publish/analyze-app-performance/gdk-xbox.md",
+      "redirect_url": "/partner-center/insights/apps-and-games-overview",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/how-tos/chatgpt-openai-winui3.md",
+      "redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/how-tos/copilot-chat-winui3.md",
+      "redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/how-tos/dall-e-winui3.md",
+      "redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/develop/notifications/app-notifications/toast-notifications-overview.md",
+      "redirect_url": "/windows/apps/develop/notifications/app-notifications/",
+      "redirect_document_id": false
     }
   ]
 }

hub/advanced-settings/developer-mode.md

@@ -58,7 +58,9 @@ When you enable Developer Mode on desktop, a package of features is installed, i
 
 ### Device Portal
 
-To learn more about Device Portal, see [Windows Device Portal overview](/windows/uwp/debug-test-perf/device-portal) and [Device Portal for desktop](/windows/uwp/debug-test-perf/device-portal-desktop).
+To learn more about Device Portal, see [Windows Device Portal overview](/windows/uwp/debug-test-perf/device-portal).
+
+For specific setup instructions, see [Device Portal for desktop](/windows/uwp/debug-test-perf/device-portal-desktop).
 
 ### Device Discovery
 
@@ -82,3 +84,107 @@ SSH login is done via the *DevToolsUser* account, which accepts a password for a
 ##### Caveats for SSH usage
 
 The existing SSH server used in Windows is not yet protocol compliant. Using an SFTP or SSH client may require special configuration. In particular, the SFTP subsystem runs at version 3 or less, so any connecting client should be configured to expect an old server. The SSH server on older devices uses `ssh-dss` for public key authentication (which OpenSSH has deprecated). To connect to such devices, the SSH client must be manually configured to accept `ssh-dss`.
+
+## Failure to install Developer Mode package
+
+Sometimes, due to network or administrative issues, Developer Mode won't install correctly. The Developer Mode package is required for remote deployment to this PC (using Device Portal from a browser or Device Discovery to enable SSH), but not for local development. Even if you encounter these issues, you can still deploy your app locally using Visual Studio (or from this device to another device).
+
+If Developer Mode doesn't install correctly, we encourage you to file a feedback request using the Feedback Hub app.
+
+> [!NOTE]
+> 1. Install the [Feedback Hub app](https://apps.microsoft.com/store/detail/feedback-hub/9NBLGGH4R32N) (if you don't already have it) and open it.
+> 2. Click **Add new feedback**.
+> 3. Choose the **Developer Platform** category and the **Developer Mode** subcategory.
+> 4. Fill out the fields (you may optionally attach a screenshot) and click **Submit**.
+>
+> Submitting feedback will help Microsoft resolve the issue you encountered.
+
+### Failed to locate the package
+
+> Developer Mode package couldn't be located in Windows Update. Error Code 0x80004005. Learn more.
+
+This error may occur due to a network connectivity problem, Enterprise settings, or the package may be missing.
+
+To fix this issue:
+
+1. Ensure that your computer is connected to the internet.
+2. If you're on a domain-joined computer, speak to your network administrator. The Developer Mode package (like all Features on Demand) is blocked by default in WSUS 2.1. In order to unblock the Developer Mode package in the current and previous releases, the following KBs should be allowed in WSUS:
+
+    - 4016509
+    - 3180030
+    - 3197985
+
+3. Check for Windows updates in **Settings → Updates and Security → Windows Updates**.
+1. Verify that the Windows Developer Mode package is present in **Settings → System → Optional features → Add a feature** (on versions older than Windows 10 22H2, look under **Settings** **→** **Apps** **→** **Apps & features** **→ Optional features** **→** **Add a feature**). If it's missing, Windows can't find the correct package for your computer.
+
+5. After performing the above steps, *disable* and then *re-enable* Developer Mode to verify the fix.
+
+### Failed to install the package
+
+> Developer Mode package failed to install. Error code 0x80004005. Learn more.
+
+This error may occur due to incompatibilities between your build of Windows and the Developer Mode package.
+
+To fix this issue:
+
+1. Check for Windows updates in the **Settings → Updates and Security → Windows Updates**.
+2. Restart your computer to ensure all updates are applied.
+
+## Use group policies or registry keys to enable a device
+
+For most developers, you'll want to use Windows Settings to enable your device for debugging. In certain scenarios (such as automated tests) you can use other ways to enable your Windows desktop device for development.
+
+> [!NOTE]
+> These steps will not enable the SSH server or allow the device to be targeted for remote deployment and debugging.
+
+You can use `gpedit.msc` to set the group policies to enable your device, unless you have *Windows 10 Home* or *Windows 11 Home*. If you do, you'll need to use regedit or PowerShell commands to set the registry keys directly to enable your device.
+
+### Use gpedit to enable your device
+
+1. Run `gpedit.msc`.
+
+2. Go to **Local Computer Policy → Computer Configuration → Administrative Templates → Windows Components → App Package Deployment**.
+
+3. Edit the following policies to enable sideloading:
+
+    - Allow all trusted apps to install.
+
+    OR
+
+    Edit the following policies to enable both sideloading and Developer Mode:
+
+    - Allow all trusted apps to install.
+    - Allows development of UWP apps and installation from an *Integrated Development Environment (IDE)*.
+    - Reboot your machine.
+
+### Use regedit to enable your device
+
+1. Run `regedit`.
+
+2. To enable sideloading, set the value of this `DWORD` to `1`:
+
+    `HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock\AllowAllTrustedApps`
+
+    OR
+
+    To enable developer mode, set the values of this `DWORD` to `1`:
+
+    `HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock\AllowDevelopmentWithoutDevLicense`
+
+### Use PowerShell to enable your device
+
+1. Run PowerShell with administrator privileges.
+
+2. To enable sideloading, run this command:
+
+    ```powershell
+    PS C:\WINDOWS\system32> reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowAllTrustedApps" /d "1"
+    ```
+
+    OR
+
+    To enable developer mode, run this command:
+
+    ```powershell
+    PS C:\WINDOWS\system32> reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1"
+    ```

hub/apps/design/accessibility/high-contrast-themes.md

@@ -69,7 +69,7 @@ A [**ResourceDictionary.ThemeDictionaries**](/uwp/api/windows.ui.xaml.resourcedi
 
 ## Contrast colors
 
-On the *Settings > Ease of access > Contrast themes* page (shown in the following image), users can select from four default contrast themes: **Aquatic**, **Desert**, **Dusk**, and **Night sky**.
+On the *Settings > Accessibility > Contrast themes* page (shown in the following image), users can select from four default contrast themes: **Aquatic**, **Desert**, **Dusk**, and **Night sky**.
 
 :::image type="content" border="false" source="images/contrast-theme-settings.png" alt-text="Contrast theme settings.":::
 

hub/apps/design/basics/navigation-basics.md

@@ -77,7 +77,7 @@ Don't overwhelm users with many navigation options.
 
 Clear paths allow for logical navigation for users. Making navigation options obvious and clarifying relationships between pages should prevent users from getting lost.
 
-![Screenshot of a mock-up of an application showing clear paths fo navigation for a user.](images/nav/clarity-image.svg)
+![Screenshot of a mock-up of an application showing clear paths for navigation for a user.](images/nav/clarity-image.svg)
 
 > *Destinations are clearly labeled so users know where they are.*
 
@@ -86,7 +86,7 @@ Clear paths allow for logical navigation for users. Making navigation options ob
 Now, let's take our design principles--consistency, simplicity, and clarity--and use them to come up with some general recommendations.
 
 - Think about your users. Trace out typical paths they might take through your app, and for each page, think about why the user is there and where they might want to go.
-- Avoid deep navigation hierarchies. If you go beyond two levels of navigation, provide a [breadcrumb bar](../controls/breadcrumbbar.md) that shows the user where they are and let's them quickly get back out. Otherwise, you risk stranding your user in a deep hierarchy that they will have difficulty leaving.
+- Avoid deep navigation hierarchies. If you go beyond two levels of navigation, provide a [breadcrumb bar](../controls/breadcrumbbar.md) that shows the user where they are and lets them quickly get back out. Otherwise, you risk stranding your user in a deep hierarchy that they will have difficulty leaving.
 - Avoid "pogo-sticking." Pogo-sticking occurs when there is related content, but navigating to it requires the user to go up a level and then down again.
 
 ## Use the right structure
@@ -204,7 +204,7 @@ Use tabs when:
     :::column span="2":::
         [**Breadcrumb**](../controls/breadcrumbbar.md)
 
-Displays a horizontal list of links to pages at each of the higher levels. The [BreadcrumbBar](../controls/breadcrumbbar.md) control implements the top navigation pattern.
+Displays a horizontal list of links to pages at each of the higher levels. The [BreadcrumbBar](../controls/breadcrumbbar.md) control implements the breadcrumb navigation pattern.
 
 Use a breadcrumb when:
 
@@ -303,7 +303,7 @@ If you choose to provide your own back stack navigation, the experience should b
 <p>The app displays content for an on-screen item, such as the details for the selected item in list/details list.</p></td>
 <td><strong>No</strong>
 <p>Enumerating items is similar to navigating within a peer group. When the user presses back, navigate to the page that preceded the current page that has the item enumeration.</p>
-<p><img src="images/back-nav/nav-enumerate.png" alt="Iterm enumeration" /></p></td>
+<p><img src="images/back-nav/nav-enumerate.png" alt="Item enumeration" /></p></td>
 </tr>
 </tbody>
 </table>

hub/apps/design/basics/titlebar-design.md

@@ -25,7 +25,7 @@ This section describes the design recommendations and behaviors of the parts of
 - The standard title bar has a height of 32px.
 - The title bar's default background is [Mica](../style/mica.md), however we recommend that title bars blend with the rest of the window if possible.
 - Title bars help users differentiate when a window is active and inactive. All title bar elements should be semi-transparent when the window is inactive.
-- The title bar colors should adjust when users switch to [high contrast themes](../accessibility/high-contrast-themes.md), or between [light and dark modes](../style/color.md).
+- The title bar colors should adjust when users switch to [high contrast themes](../accessibility/high-contrast-themes.md), or between [light and dark modes](../signature-experiences/color.md).
   - For high contrast themes, apps should use the `SystemColors` class for determining proper UI element coloring to facilitate a superior high-contrast experience.
 
 **Behavior**
@@ -62,7 +62,7 @@ This section describes the design recommendations and behaviors of the parts of
 
 - A right-click/press-and-hold on the icon should show the system window menu.
 - A double-click/tap should toggle between maximizing the window and restoring the window.
-- The window title and other textual elements in the title bar should respond to [text-scaling](../input/text-scaling.md). This might require that the title bar grows in height.
+- The window title and other textual elements in the title bar should respond to [text-scaling](../../develop/input/text-scaling.md). This might require that the title bar grows in height.
 
 ### Caption controls (minimize, maximize, restore, close)
 

hub/apps/design/globalizing/globalizing-portal.md

@@ -54,13 +54,12 @@ Most localization teams use special tools to aid the process. For example, by re
 | [Guidelines for globalization](guidelines-and-checklist-for-globalizing-your-app.md) | Design and develop your app in such a way that it functions appropriately on systems with different language and culture configurations. |
 | [Understand user profile languages and app manifest languages](manage-language-and-region.md) | This topic defines the terms "user profile language list", "app manifest language list", and "app runtime language list". We'll be using these terms in this topic and other topics in this feature area, so it's important to know what they mean. |
 | [Globalize your date/time/number formats](use-global-ready-formats.md) | Design your app to be global-ready by appropriately formatting dates, times, numbers, phone numbers, and currencies. You'll then be able later to adapt your app for additional cultures, regions, and languages in the global market. |
-| [Use templates and patterns to format dates and times](use-patterns-to-format-dates-and-times.md) | Use classes in the [**Windows.Globalization.DateTimeFormatting**](/uwp/api/windows.globalization.datetimeformatting?branch=live) namespace with custom templates and patterns to display dates and times in exactly the format you wish. |
+| [Use templates and patterns to format dates and times](use-patterns-to-format-dates-and-times.md) | Use classes in the [**Windows.Globalization.DateTimeFormatting**](/uwp/api/windows.globalization.datetimeformatting) namespace with custom templates and patterns to display dates and times in exactly the format you wish. |
 | [Adjust layout and fonts, and support RTL](adjust-layout-and-fonts--and-support-rtl.md) | Design your app to support the layouts and fonts of multiple languages, including RTL (right-to-left) flow direction. |
-| [NumeralSystem values](glob-numeralsystem-values.md) | This topic lists the values available to the **NumeralSystem** property of various classes in the [**Windows.Globalization**](/uwp/api/windows.globalization?branch=live) namespace. |
+| [NumeralSystem values](glob-numeralsystem-values.md) | This topic lists the values available to the **NumeralSystem** property of various classes in the [**Windows.Globalization**](/uwp/api/windows.globalization) namespace. |
 | [Make your app localizable](prepare-your-app-for-localization.md) | A localized app is one that can be localized to other markets, languages, or regions without uncovering any functional defects in the app. The most essential property of a localizable app is that its executable code has been cleanly separated from its localizable resources. |
 | [International fonts](loc-international-fonts.md) | This topic lists the fonts available for Windows apps that are localized into languages other than U.S. English. |
 | [Design your app for bidirectional text](design-for-bidi-text.md) | Design your app to provide bi-directional text support (BiDi) so that you can combine script from left-to-right and right-to-left writing systems. |
-| [Use the Multilingual App Toolkit 4.0](use-mat.md) | The Multilingual App Toolkit (MAT) 4.0 integrates with Microsoft Visual Studio 2017 and later to provide Windows apps with translation support, translation file management, and editor tools. |
-| [Multilingual App Toolkit 4.0 FAQ & troubleshooting](mat-faq-troubleshooting.yml) | This topic provides answers to frequently-asked questions and issues related to the Multilingual App Toolkit (MAT) 4.0. |
+| [Multilingual App Toolkit (MAT) announcements](mat-announcements.md) | The Multilingual App Toolkit (MAT) reached end-of-support on October 15, 2025, and is no longer available for new installations. Existing users can continue to use it without loss of functionality. |
 | [Use the UTF-8 code page](use-utf8-code-page.md) | UTF-8 is the universal code page for internationalization. |
 | [Prepare your application for the Japanese era change](japanese-era-change.md) | Learn about the May 2019 Japanese era change and how to prepare your application. |

hub/apps/design/layout/attached-layouts.md

@@ -292,7 +292,7 @@ The UI for the Xbox Activity Feed uses a repeating pattern where each line has a
 The code below walks through what a custom virtualizing UI for the activity feed might be to illustrate the general approach you might take for a **data layout**.
 
 > [!TIP]
-> If you have the **WinUI 3 Gallery** app installed, click here to [open the app and see the ItemsRepeater in action](winui3gallery:/item/ItemsRepeater). Get the app from the [Microsoft Store](https://apps.microsoft.com/detail/9P3JFPWWDZRC) or get the source code on [GitHub](https://github.com/microsoft/WinUI-Gallery).
+> If you have the **WinUI 3 Gallery** app installed, click here to [open the app and see the ItemsRepeater in action](winui3gallery://item/ItemsRepeater). Get the app from the [Microsoft Store](https://apps.microsoft.com/detail/9P3JFPWWDZRC) or get the source code on [GitHub](https://github.com/microsoft/WinUI-Gallery).
 
 #### Implementation
 

hub/apps/design/layout/responsive-design.md

@@ -6,7 +6,7 @@ op-migration-status: ready
 ms.date: 09/25/2024
 ms.topic: article
 keywords: windows 10, uwp
-localizationpriority: medium
+ms.localizationpriority: medium
 ms.custom: RS5
 ---
 # Responsive design techniques

hub/apps/design/signature-experiences/color.md

@@ -41,7 +41,7 @@ Accent color is used to emphasize important elements in the user interface and t
 ## Examples
 
 > [!div class="nextstepaction"]
-> [Open the WinUI 3 Gallery app and see Color principles in action](winui3gallery:/item/Color)
+> [Open the WinUI 3 Gallery app and see Color principles in action](winui3gallery://item/Color)
 
 [!INCLUDE [winui-3-gallery](../../../includes/winui-3-gallery.md)]
 

hub/apps/design/signature-experiences/iconography.md

@@ -89,6 +89,6 @@ Understand the cultural connotations of symbols. Although iconography doesn't re
 ## Examples
 
 > [!div class="nextstepaction"]
-> [Open the WinUI 3 Gallery app and see Iconography principles in action](winui3gallery:/item/Iconography)
+> [Open the WinUI 3 Gallery app and see Iconography principles in action](winui3gallery://item/Iconography)
 
 [!INCLUDE [winui-3-gallery](../../../includes/winui-3-gallery.md)]