refinements (#6554)

Karl-Bridge-Microsoft · web-flow · commit 48f288f48f60 · 2026-03-26T12:08:40.000-07:00
* refinements

* build warnings

* build warnings

* build warnings

* build warnings
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -1462,8 +1462,13 @@
     },
     {
       "source_path": "uwp/accessibility/accessibility.md",
-      "redirect_url": "/windows/uwp/design/accessibility/accessibility",
-      "redirect_document_id": true
+      "redirect_url": "/windows/uwp/design/accessibility/accessibility-overview",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/design/accessibility/accessibility.md",
+      "redirect_url": "/windows/uwp/design/accessibility/accessibility-overview",
+      "redirect_document_id": false
     },
     {
       "source_path": "uwp/accessibility/accessible-text-requirements.md",
diff --git a/hub/apps/design/accessibility/accessibility-checklist.md b/hub/apps/design/accessibility/accessibility-checklist.md
@@ -76,6 +76,5 @@ Use the following recommendations during design, implementation, and testing. To
 
 - [Accessible text requirements](accessible-text-requirements.md)
 - [Text scaling](../input/text-scaling.md)
-- [Accessibility](accessibility.md)
 - [Design for accessibility](./accessibility-overview.md)
 - [Practices to avoid](practices-to-avoid.md)
diff --git a/hub/apps/design/accessibility/accessibility-in-the-store.md b/hub/apps/design/accessibility/accessibility-in-the-store.md
@@ -40,4 +40,4 @@ See the [Accessibility checklist](accessibility-checklist.md) for more detail on
 
 ## Related topics
 
-- [Accessibility](accessibility.md)
+- [Accessibility overview](accessibility-overview.md)
diff --git a/hub/apps/design/accessibility/accessibility-overview.md b/hub/apps/design/accessibility/accessibility-overview.md
@@ -14,6 +14,8 @@ ms.localizationpriority: medium
 
 This topic introduces concepts and technologies related to building accessible Windows apps.
 
+Accessible Windows applications support not only people with disabilities (both temporary and permanent) but also those with personal preferences, specific work styles, or situational and environmental constraints (such as shared work spaces, low bandwidth, bright sunlight, noisy or quiet surroundings, while cooking, and so on).
+
 The guidance is written for development teams that treat accessibility as a core quality requirement and use automated accessibility checks as part of regular engineering workflows. Use these topics to define accessibility expectations early, validate them continuously, and prevent regressions as features evolve.
 
 Many disabilities, including impaired mobility, vision, color perception, hearing, speech, cognition, and literacy, can be addressed by providing:
@@ -131,17 +133,17 @@ For more info about accessibility declarations and publishing your app, see [Acc
 > [!TIP]
 > [!div class="nextstepaction"]
 > Open the WinUI 3 Gallery app and see the following Accessibility principles in action:
->
+> 
 > - [Screen reader support](winui3gallery://item/AccessibilityScreenReader)
 > - [Keyboard support](winui3gallery://item/AccessibilityKeyboard)
 > - [Color contrast](winui3gallery://item/AccessibilityColorContrast)
->
+> 
 > The **WinUI 3 Gallery** app includes interactive examples of most WinUI controls, features, and functionality. 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)
 
 ## Related topics
 
 - [Microsoft.UI.Xaml.Automation](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.automation)
 - [Microsoft.UI.Xaml.Automation](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.automation)
 - [XAML accessibility sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/master/Official%20Windows%20Platform%20Sample/XAML%20accessibility%20sample) (archived legacy sample)
-- [Accessibility](accessibility.md)
+- [Accessibility overview](accessibility-overview.md)
 - [Get started with Narrator](https://support.microsoft.com/help/22798/windows-10-complete-guide-to-narrator)
diff --git a/hub/apps/design/accessibility/accessibility-testing.md b/hub/apps/design/accessibility/accessibility-testing.md
@@ -160,7 +160,7 @@ Verify that only intended elements appear in each accessibility view and that re
 
 ## Related topics
 
-- [Accessibility](accessibility.md)
+- [Accessibility overview](accessibility-overview.md)
 - [Practices to avoid](practices-to-avoid.md)
 - [UI Automation](/windows/desktop/WinAuto/entry-uiauto-win32)
 - [Accessibility in Windows](https://www.microsoft.com/accessibility/)
diff --git a/hub/apps/design/accessibility/accessibility.md b/hub/apps/design/accessibility/accessibility.md
diff --git a/hub/apps/design/accessibility/accessible-text-requirements.md b/hub/apps/design/accessibility/accessible-text-requirements.md
@@ -184,7 +184,7 @@ These types have an **IsTextScaleFactorEnabled** property:
 ## Related topics  
 
 - [Text scaling](../input/text-scaling.md)
-- [Accessibility](accessibility.md)
+- [Accessibility overview](accessibility-overview.md)
 - [Basic accessibility information](basic-accessibility-information.md)
 - [XAML text display sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%23%5D-Windows%208%20app%20samples/C%23/Windows%208%20app%20samples/XAML%20text%20display%20sample%20(Windows%208)) (archived legacy sample)
 - [XAML text editing sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%23%5D-Windows%208%20app%20samples/C%23/Windows%208%20app%20samples/XAML%20text%20editing%20sample%20(Windows%208)) (archived legacy sample)
diff --git a/hub/apps/design/accessibility/basic-accessibility-information.md b/hub/apps/design/accessibility/basic-accessibility-information.md
@@ -127,7 +127,7 @@ Attached properties in [**AutomationProperties**](/windows/windows-app-sdk/api/w
 
 ## Related topics
 
-* [Accessibility](accessibility.md)
+* [Accessibility overview](accessibility-overview.md)
 * [**AutomationProperties.Name**](/dotnet/api/system.windows.automation.automationproperties.name)
 * [XAML accessibility sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/XAML%20accessibility%20sample) (archived legacy sample)
 * [Accessibility testing](accessibility-testing.md)
diff --git a/hub/apps/design/accessibility/control-patterns-and-interfaces.md b/hub/apps/design/accessibility/control-patterns-and-interfaces.md
@@ -63,4 +63,4 @@ When you implement a control pattern, you should also consult the UI Automation
 ## Related topics
 
 * [Custom automation peers](custom-automation-peers.md)
-* [Accessibility](accessibility.md)
+* [Accessibility overview](accessibility-overview.md)
diff --git a/hub/apps/design/accessibility/custom-automation-peers.md b/hub/apps/design/accessibility/custom-automation-peers.md
@@ -460,7 +460,7 @@ More generally, be conservative with exceptions. Many clients cannot convert pro
 
 ## Related topics
 
-* [Accessibility](accessibility.md)
+* [Accessibility overview](accessibility-overview.md)
 * [XAML accessibility sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/XAML%20accessibility%20sample) (archived legacy sample)
 * [**FrameworkElementAutomationPeer**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.automation.peers.frameworkelementautomationpeer)
 * [**AutomationPeer**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.automation.peers.automationpeer)
diff --git a/hub/apps/design/accessibility/designing-inclusive-software.md b/hub/apps/design/accessibility/designing-inclusive-software.md
@@ -113,4 +113,4 @@ In summary, apply these seven steps to keep inclusive design actionable througho
 * [Engineering Software for Accessibility](https://www.microsoft.com/download/details.aspx?id=19262)
 * [Microsoft accessibility developer hub](https://developer.microsoft.com/windows/accessible-apps)
 * [Developing inclusive Windows apps](developing-inclusive-windows-apps.md)
-* [Accessibility](accessibility.md)
+* [Accessibility overview](accessibility-overview.md)
diff --git a/hub/apps/design/accessibility/developing-inclusive-windows-apps.md b/hub/apps/design/accessibility/developing-inclusive-windows-apps.md
@@ -92,4 +92,4 @@ For more detail, please see the full [Accessibility checklist](accessibility-che
 * [Accessibility practices to avoid](practices-to-avoid.md)
 * [Engineering Software for Accessibility](https://www.microsoft.com/download/details.aspx?id=19262)
 * [Microsoft accessibility developer hub](https://developer.microsoft.com/windows/accessible-apps)
-* [Accessibility](accessibility.md)
+* [Accessibility overview](accessibility-overview.md)
diff --git a/hub/apps/design/accessibility/high-contrast-themes.md b/hub/apps/design/accessibility/high-contrast-themes.md
@@ -256,7 +256,7 @@ The following code snippet (from an App.xaml file) shows an example [**ThemeDict
 
 ## Related topics
 
-- [Accessibility](accessibility.md)
+- [Accessibility overview](accessibility-overview.md)
 - [UI contrast and settings sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%23%5D-Windows%208%20app%20samples/C%23/Windows%208%20app%20samples/XAML%20high%20contrast%20style%20sample%20(Windows%208)) (archived legacy sample)
 - [XAML accessibility sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/XAML%20accessibility%20sample) (archived legacy sample)
 - [XAML high contrast sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%23%5D-Windows%208%20app%20samples/C%23/Windows%208%20app%20samples/XAML%20high%20contrast%20style%20sample%20(Windows%208)) (archived legacy sample)
diff --git a/hub/apps/design/accessibility/keyboard-accessibility.md b/hub/apps/design/accessibility/keyboard-accessibility.md
@@ -304,7 +304,7 @@ For example, even without a physical Tab key, Narrator supports gestures that ma
 
 ## Related topics
 
-- [Accessibility](accessibility.md)
+- [Accessibility overview](accessibility-overview.md)
 - [Keyboard interactions](../input/keyboard-interactions.md)
 - [Touch keyboard sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/TouchKeyboard) (legacy sample)
 - [XAML accessibility sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/XAML%20accessibility%20sample) (archived legacy sample)
diff --git a/hub/apps/design/accessibility/practices-to-avoid.md b/hub/apps/design/accessibility/practices-to-avoid.md
@@ -30,6 +30,6 @@ When you build accessible Windows experiences, avoid the following implementatio
 
 ## Related topics
 
-* [Accessibility](accessibility.md)
+* [Accessibility overview](accessibility-overview.md)
 * [Accessibility in the Store](accessibility-in-the-store.md)
 * [Accessibility checklist](accessibility-checklist.md)
diff --git a/hub/apps/design/toc.yml b/hub/apps/design/toc.yml
@@ -77,10 +77,8 @@ items:
         - name: Overview
           href: usability/index.md
         - name: Accessibility
-          href: accessibility/accessibility.md
+          href: accessibility/accessibility-overview.md
           items:
-            - name: Overview
-              href: accessibility/accessibility-overview.md
             - name: Designing inclusive software
               href: accessibility/designing-inclusive-software.md
             - name: Developing inclusive Windows apps
diff --git a/hub/apps/design/usability/index.md b/hub/apps/design/usability/index.md
@@ -11,15 +11,15 @@ ms.localizationpriority: medium
 
 # Usability for Windows apps
 
-It’s the little touches, an extra attention to detail, that can transform a good user experience into a truly inclusive user experience that meets the needs of users around the globe.
+It's the little touches, an extra attention to detail, that can transform a good user experience into a truly inclusive user experience that meets the needs of users around the globe.
 
 The design and coding instructions in this section can make your Windows app more inclusive by adding accessibility features, enabling globalization and localization, enabling users to customize their experience, and providing help when users need it.
 
 ## Accessibility
 
 Accessibility is about making your app usable by people who have limitations that prevent or impede the use of conventional user interfaces. For some situations, accessibility requirements are imposed by law. However, it's a good idea to address accessibility issues regardless of legal requirements so that your apps have the largest possible audience.
 
-[Accessibility portal](../accessibility/accessibility.md)
+[Accessibility overview](../accessibility/accessibility-overview.md)
 
 <!--
 <ul class="panelContent cardsH">
@@ -216,7 +216,7 @@ Windows is used worldwide by audiences that are diverse in terms of language, re
 <a href="../globalizing/globalizing-portal.md">Globalization and localization portal</a>
 
 ## In-app help
-No matter how well you’ve designed your app, some users will need a little extra help.
+No matter how well you've designed your app, some users will need a little extra help.
 
 :::row:::
     :::column:::
diff --git a/hub/apps/develop/input/input-method-editor-requirements.md b/hub/apps/develop/input/input-method-editor-requirements.md
@@ -42,7 +42,7 @@ TSF is the intermediary between the app and your IME. TSF communicates input eve
 
 This behavior is the same as previous versions of Windows, but being loaded into a Windows app affects the potential capabilities of an IME.
 
-If your IME needs to provide different functionality or UI between Windows apps and desktop apps, ensure that the DLL that’s loaded by TSF checks which type of app it's being loaded into. Call the [ITfThreadMgrEx::GetActiveFlags](/windows/win32/api/msctf/nf-msctf-itfthreadmgrex-getactiveflags) method in your IME and check the TF_TMF_IMMERSIVEMODE flag, so your IME triggers different application logic depending on the result.
+If your IME needs to provide different functionality or UI between Windows apps and desktop apps, ensure that the DLL that's loaded by TSF checks which type of app it's being loaded into. Call the [ITfThreadMgrEx::GetActiveFlags](/windows/win32/api/msctf/nf-msctf-itfthreadmgrex-getactiveflags) method in your IME and check the TF_TMF_IMMERSIVEMODE flag, so your IME triggers different application logic depending on the result.
 
 Windows apps do not support Table Text Service (TTS) IMEs.
 
@@ -76,7 +76,7 @@ Some IME functions are affected in an app container.
 - **Dictionary Files** - Frequently, IMEs have read-only dictionary files to map user input to specific characters. To access these files from inside an app container, your IME must place them under the Program Files or Windows directories. By default, these directories can be read from an app container, so IMEs can access dictionary files that are stored in these locations. If your IME must store the dictionary file somewhere else, it must explicitly manipulate the [Access Control Lists (ACL)](/windows/win32/secauthz/access-control-lists) of the dictionary files to allow access from app containers.
 - **Internet Updating** - If your IME needs to update its dictionaries using data from the Internet, it can't reliably do so inside an app container, because Internet access isn't always permitted. Instead, your IME should run a separate desktop process that's responsible for updating the dictionary files with data from the Internet.
 - **On-the-fly learning** - If an IME is running in an app container that has Internet access, there's no restriction on the endpoints that the IME can communicate with. In this case, an IME can use a cloud server to provide on-the-fly learning services. Some IMEs download and upload user input on the fly, while the user is typing. Since Internet access is not guaranteed in an app container, this may not always be allowed.
-- **Sharing information between processes** - IMEs may need to share data about the user’s input preferences between apps that are in different app containers. Use a web service to share data between apps.
+- **Sharing information between processes** - IMEs may need to share data about the user's input preferences between apps that are in different app containers. Use a web service to share data between apps.
 
 > [!Important]
 > If you try to circumvent app container security rules, your IME may be treated as malware and blocked.
@@ -296,4 +296,4 @@ Implement the following convention to make your IMEs conform to the accessibilit
 - [ITfFnSearchCandidateProvider](/windows/win32/api/ctffunc/nn-ctffunc-itffnsearchcandidateprovider)
 - [ITfIntegratableCandidateListUIElement](/windows/win32/api/ctffunc/nn-ctffunc-itfintegratablecandidatelistuielement)
 - [SendInput](/windows/win32/api/winuser/nf-winuser-sendinput)
-- [Accessibility](../../design/accessibility/accessibility.md)
+- [Accessibility overview](../../design/accessibility/accessibility-overview.md)
diff --git a/hub/apps/develop/ui/controls/forms.md b/hub/apps/develop/ui/controls/forms.md
diff --git a/hub/apps/get-started/best-practices.md b/hub/apps/get-started/best-practices.md
diff --git a/hub/apps/publish/publish-your-app/add-on/product-declarations.md b/hub/apps/publish/publish-your-app/add-on/product-declarations.md
diff --git a/hub/apps/publish/publish-your-app/msix/product-declarations.md b/hub/apps/publish/publish-your-app/msix/product-declarations.md
diff --git a/hub/apps/publish/publish-your-app/pwa/product-declarations.md b/hub/apps/publish/publish-your-app/pwa/product-declarations.md
diff --git a/hub/includes/apps-develop-overview.md b/hub/includes/apps-develop-overview.md

Original file line number	Diff line number	Diff line change
`@@ -40,4 +40,4 @@ See the [Accessibility checklist](accessibility-checklist.md) for more detail on`
`40`	`40`
`41`	`41`	`## Related topics`
`42`	`42`
`43`		`-- [Accessibility](accessibility.md)`
	`43`	`+- [Accessibility overview](accessibility-overview.md)`