Merge pull request #3361 from epapa/ep-snap-layouts

Update Windows 11 snap layouts documentation

Author: ktoliver

hub/apps/desktop/modernize/apply-snap-layout-menu.md

@@ -1,35 +1,35 @@
 ---
-description: Apply the snap layout menu in your desktop application.
-title: Apply the snap layout menu in desktop apps
+description: Support the snap layouts menu in your desktop application.
+title: Support snap layouts for desktop apps on Windows 11
 ms.topic: article
-ms.date: 08/12/2021
+ms.date: 09/21/2021
 ms.author: jimwalk
 author: jwmsft
 ms.localizationpriority: medium
 ---
 
-# Apply the Snap Layout Menu in desktop apps for Windows 11
+# Support snap layouts for desktop apps on Windows 11
 
-The Snap Layout Menu is a key feature in Windows 11 to help introduce users to the power of window snapping. With the menu, users can quickly layout their windows to multitask on larger screens and create an entire layout with Guided Snap Assist by simply hovering the mouse over the maximize button or pressing Win + Z​.  
+Snap layouts are a new Windows 11 feature to help introduce users to the power of window snapping. Snap layouts are easily accessible by hovering the mouse over a window's maximize button or pressing Win + Z. After invoking the menu that shows the available layouts, users can click on a zone in a layout to snap a window to that particular zone and then use Snap Assist to finish building an entire layout of windows. Snap layouts are tailored to the current screen size and orientation, including support for three side-by-side windows on large landscape screens and top/bottom stacked windows on portrait screens.
 
 :::image type="content" source="./images/apply-design/snap-layout-menu.png" alt-text="The Notepad app on Windows 11 with rounded corners.":::
 
-On Windows 11, if the application has the maximize caption button available, the system automatically provides the snap layout menu for all inbox apps, including all UWP apps, and most other apps. However, some desktop apps may not have the snap layout menu. This topic describes how to allow the snap layout menu to appear if the system does not provide it automatically.
+If the app's window has the maximize caption button available, the system will automatically show snap layouts when a user hovers the mouse over the window's maximize button. Snap layouts will appear automatically for most apps, but some desktop apps may not show snap layouts. This topic describes how to make sure your app shows the menu with snap layouts if the system does not show it automatically.
 
-## Why doesn't my app have the snap layout menu?
+## Why doesn't my app show the snap layouts menu?
 
-If your application's main window has the maximize caption button available but does not provide the snap layout menu, it may be because you've customized your caption buttons or title bar in a way that prevents it.  
+If your app's main window has the maximize caption button available but does not show snap layouts, it may be because you've customized your caption buttons or title bar in a way that prevents it.
 
 ## How do I fix it?
 
 If you have a custom title bar, you can:​
 
 - Use the [Windows App SDK windowing APIs](../../windows-app-sdk/windowing/windowing-overview.md) and have the platform draw and implement the caption buttons for you​.
 - For Win32 apps, make sure you are responding appropriately to [WM_NCHITTEST](/windows/win32/inputdev/wm-nchittest) (with a return value of `HTMAXBUTTON` for the maximize/restore button)​.
-- If your app uses [Electron](https://www.electronjs.org/), you can update to the v13 stable release of Electron to enable snap flyouts for your app.
+- If your app uses [Electron](https://www.electronjs.org/), update to the v13 stable release of Electron to enable snap layouts.
 
-## What if my window has the snap layout menu but isn't snapping properly?  
+## What if my app's window shows snap layouts but isn't snapping properly?  
 
-If your application can invoke the snap layout menu but isn't able to snap properly to the snap zones, it may be because your application's minimum size is too large for the snap zone to fit properly.  
+If your app can invoke the menu with snap layouts but isn't able to snap properly to the zone sizes, it's likely that your app's minimum window size is too large for the window to fit in the selected zone.
 
-Your application should support a minimum width of at most 500epx for snapping to work properly. However, we recommend that you support an even smaller minimum width (330epx or less) as it will be compatible with a larger set of devices and snap layouts.
+Your app should support a minimum width of at *most* 500 effective pixels (epx) to support snap layouts across the most common screen sizes. However, we recommend that you support an even smaller minimum width (330 epx or less) so that it's compatible with a larger set of devices and snap layouts.

hub/apps/desktop/modernize/index.md

@@ -2,7 +2,7 @@
 description: Add modern XAML user interfaces, create MSIX packages, and incorporate other modern components into your desktop application.
 title: Modernize your desktop apps for Windows
 ms.topic: article
-ms.date: 10/02/2020
+ms.date: 09/21/2021
 ms.author: mcleans
 author: mcleanbyron
 ms.localizationpriority: medium
@@ -19,7 +19,7 @@ This article describes the features that you can use in your desktop apps today.
 
 ## Apply Windows 11 features
 
-Windows 11 marks a visual evolution of the Windows operating system, and introduces new features that improve app fundamentals and user experience. Many of these features are enabled by default for apps, but desktop apps may require updates to integrate with some new features. These features include rounded corners of top-level windows, the Snap Layout Menu, and the updated context menu in File Explorer.
+Windows 11 marks a visual evolution of the Windows operating system, and introduces new features that improve app fundamentals and user experience. Many of these features are enabled by default for apps, but desktop apps may require updates to integrate with some new features. These features include rounded corners of top-level windows, snap layouts, and the updated context menu in File Explorer.
 
 For more information, see [Top 11 things you can do to make your app great on Windows 11](../../get-started/make-apps-great-for-windows.md).
 

hub/apps/get-started/make-apps-great-for-windows.md

@@ -2,7 +2,7 @@
 description: The top 11 things you can do to make your app great on Windows 11.
 title: Top 11 things you can do to make your app great on Windows 11
 ms.topic: article
-ms.date: 08/12/2021
+ms.date: 09/21/2021
 keywords: windows win32, desktop development
 ms.author: jimwalk
 author: jwmsft
@@ -99,24 +99,24 @@ We are introducing a new material called _Mica_ that lets the user's desktop bac
 
 [Mica guidance](../design/style/mica.md), [Acrylic guidance](../design/style/acrylic.md)
 
-## 6. Make your Windows use rounded corners and Snap Layout Menu
+## 6. Use rounded corners for your windows and support snap layouts
 
-App windows have new features like rounded corners and the Snap Layout Menu that your app will get automatically in most cases. If you've customized you window or title bar, you might need to do some work to make sure these new features are used.
+App windows have new features like rounded corners and a menu with snap layouts that your app will automatically receive in most cases. If you've customized your window or title bar, you might need to do some work to make sure these new features are supported.
 
 We rounded the corners of window borders in Windows 11. Our user research team found that rounded geometry psychologically provides a feeling of safety and makes the app's UI much easier to scan. This makes users feel less intimidated and the app feel more engaging. The amount of rounding was also carefully chosen. We worked across the company and user research to balance between feeling professional and being softer and more inviting.
 
 ![An image of an app window with rounded corners.](images/great-apps/rounded-corners.png)
 
-The Snap Layout Menu is a key feature in Windows 11 to help introduce users to the power of window snapping. With the menu, users can quickly layout their windows to multitask on larger screens and create an entire layout with Guided Snap Assist by simply hovering the mouse over the maximize button or pressing Win + Z​.
+Snap layouts are a new Windows 11 feature to help introduce users to the power of window snapping. Snap layouts are easily accessible by hovering the mouse over a window's maximize button or pressing Win + Z. After invoking the menu that shows the available layouts, users can click on a zone in a layout to snap a window to that particular zone and then use Snap Assist to finish building an entire layout of windows. Snap layouts are tailored to the current screen size and orientation, including support for three side-by-side windows on large landscape screens and top/bottom stacked windows on portrait screens.
 
-- Most apps will automatically receive rounded corners and the Snap Layout Menu, but in some cases you might need to do a little work to get them:
+- Most apps will automatically receive rounded corners and support for the menu with snap layouts, but in some cases you might need to do a little work to get them:
   - Allow the system to draw your border and shadow.
   -  If you need to draw your own border and shadow:
      - Call our rounding API to opt in. See [Apply rounded corners in desktop apps for Windows 11](../desktop/modernize/apply-rounded-corners.md).
-     - Use our APIs to have the platform draw and implement the caption buttons. See [Apply the Snap Layout Menu in desktop apps for Windows 11](../desktop/modernize/apply-snap-layout-menu.md).
+     - Use our APIs to have the platform draw and implement the caption buttons. See [Support snap layouts for desktop apps on Windows 11](../desktop/modernize/apply-snap-layout-menu.md).
 - You will get these features automatically if you use UWP or you adopt Windows App SDK windowing to:
   - Configure the style of your window using the pre-defined templates.
-  - Customize the TitleBar of your windows.
+  - Customize the title bar of your windows.
 
 ## 7. Support Dark and Light themes
 

hub/apps/toc.yml

@@ -139,7 +139,7 @@
                     href: get-started/make-apps-great-for-windows.md
                   - name: Apply rounded corners in Windows 11
                     href: desktop/modernize/apply-rounded-corners.md
-                  - name: Apply the Snap Layout Menu
+                  - name: Support snap layouts on Windows 11
                     href: desktop/modernize/apply-snap-layout-menu.md
             - name: Call Windows Runtime APIs
               items: