pass 4

Author: Jay-o-Way

specs/AnimatedVisualPlayer Spec.md

@@ -53,8 +53,9 @@ when the player is idle (when `PlayAsync` is not active).
 |Resources | AnimatedVisualPlayer will not create animations until `PlayAsync()` is called, and will destroy them when it completes.
 If you call pause, this does not free up all resources of the player. To truly stop the animation, call Stop. |
 
-Note: If you set the `Source` or `AnimationOptimization` of your player, the player will defer
-processing of the source file until the layout is being formed.
+> [!NOTE]
+> If you set the `Source` or `AnimationOptimization` of your player,
+> the player will defer processing of the source file until the layout is being formed.
 
 If you have an animation that will start on click, you may want to initialize
 the property to `None` and set `AnimationOptimization` to 'Always'

specs/DateTimePicker-Visual-Updates-Spec.md

@@ -54,9 +54,9 @@ To allow pointer events to get to the source element, set the overlay's
 [UIElement.IsHitTestVisible](https://learn.microsoft.com/uwp/api/Windows.UI.Xaml.UIElement.IsHitTestVisible)
 property to false.
 
-> Note: the element set as the `SourceElement` cannot be an ancestor or in the descendancy of
-the `MonochromaticOverlayPresenter`. However the `SourceElement` must be in the same XAML tree as
-the `MonochromaticOverlayPresenter`.
+> [!NOTE]
+> The element set as the `SourceElement` cannot be an ancestor or in the descendancy of the `MonochromaticOverlayPresenter`.
+> However the `SourceElement` must be in the same XAML tree as the `MonochromaticOverlayPresenter`.
 
 If the `ReplacementColor` property is set and has a nonzero Alpha value, then the `SourceElement`
 is treated as a mask: every non-transparent pixel will be replaced by this color. The RGB value
@@ -140,7 +140,7 @@ article.
 ## Other MonochromaticOverlayPresenter members
 
 | Name | Description |
-| - | - |
+| --- | --- |
 | SourceElement | Gets or sets the UIElement to render inside the `MonochromaticOverlayPresenter`. |
 | ReplacementColor | Gets or sets the Color to use instead of the non-transparent pixels of the SourceElement.
 

specs/FooterMenuItemTemplate-spec.md

@@ -48,7 +48,7 @@ Example showing how a NavigationView can have different object types for main an
 The following APIs are members of `NavigationView`.
 
 | Name | Description |
-| - | - |
+| --- | --- |
 | FooterMenuItemTemplate | Gets or sets the [DataTemplate](https://learn.microsoft.com/uwp/api/windows.ui.xaml.datatemplate) used to display each footer menu item. |
 | FooterMenuItemTemplateSelector | Gets or sets a reference to a custom [DataTemplateSelector](https://learn.microsoft.com/uwp/api/windows.ui.xaml.controls.datatemplateselector) logic class. The DataTemplateSelector referenced by this property returns a template to apply to Navigation items placed in the footer menu. |
 

specs/appwindow-spec.md

@@ -1,20 +1,20 @@
 Window.AppWindow API
 ===
 
-New API to simplify accessing [AppWindow](https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/windowing/windowing-overview)
+New API to simplify accessing [AppWindow](https://learn.microsoft.com/windows/apps/windows-app-sdk/windowing/windowing-overview)
 functionality through WinUI 3 code.
 
 # Background
 
 XAML has a [Window](https://learn.microsoft.com/uwp/api/Windows.UI.Xaml.Window) API that
-internally wraps an hwnd. Windows has an [AppWindow](https://learn.microsoft.com/uwp/api/Windows.UI.WindowManagement.AppWindow) class
-that similarly wraps an hwnd in UWP. WinAppSDK has a new [AppWindow](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/Microsoft.UI.Windowing.AppWindow) which wraps an hwnd and works on Desktop.
+internally wraps an HWND. Windows has an [AppWindow](https://learn.microsoft.com/uwp/api/Windows.UI.WindowManagement.AppWindow) class
+that similarly wraps an HWND in UWP. WinAppSDK has a new [AppWindow](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/Microsoft.UI.Windowing.AppWindow) which wraps an HWND and works on Desktop.
 
 You can get an AppWindow from a XAML Window by calling a COM API to get XAML and then
-a DLL export API to convert the hwnd to an AppWindow. This spec adds a simple `Window.AppWindow`
+a DLL export API to convert the HWND to an AppWindow. This spec adds a simple `Window.AppWindow`
 property to make this much easier and more discoverable.
 
-[XAML Window](https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.window) will
+[XAML Window](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.window) will
 expose AppWindow object directly to app developer through an API. Instead of writing a lot of boilerplate
 code everywhere, app developer can use this API, reducing code bloat, and making AppWindow APIs easily
 accessible from WinUI 3 code.
@@ -73,13 +73,13 @@ an observable behavior change from the behavior before the introduction of this
 
 New subclassing order with this new feature change:
 
-* ContentAppWindowBridge
-  ↓
-* AppWindow  
-  ↓
-* XAML Window  
+- ContentAppWindowBridge<br/>
 &darr;
-* DefaultWndProc
+- AppWindow  
+&darr;
+- XAML Window  
+&darr;
+- DefaultWndProc
 
 # API Details
 

specs/public-api-review-process.md

@@ -93,7 +93,7 @@ We are committed to respond to all feedback in different manners depending on th
 
 - **Discussion:**
 
-  - A “eye” emoji by the author / poster to signify that it is read.
+  - An “eye” emoji by the author / poster to signify that it is read.
 
 ## Consolidate Feedback
 

specs/xaml-backdrop-api.md

@@ -94,7 +94,8 @@ For example:
 </Window>
 ```
 
-Note that `MicaBackdrop` isn't supported on all systems. In such cases a solid color will be used instead of the Mica effect.
+> [!NOTE]
+> Note that `MicaBackdrop` isn't supported on all systems. In such cases a solid color will be used instead of the Mica effect.
 
 ## SystemBackdrop class
 

specs/xaml-resource-references-tracing-spec.md

@@ -119,8 +119,10 @@ Below is an example message from the WinUI Gallery sample app after an incorrect
 that the desired resource is defined in `App.xaml`, then the failure to locate it in there is a
 strong indicator of an erroneous reference.
 
-Note: The below example output is for illustrative purposes only. The precise format of the message is
-implementation-defined and may change in the future. Applications should not attempt to parse the message.
+> [!NOTE]
+> The below example output is for illustrative purposes only.
+> The precise format of the message is implementation-defined and may change in the future.
+> Applications should not attempt to parse the message.
 
 ```text
 Beginning search for resource with key 'OutputTextBlockStyl'.