Merge branch 'main' of https://cpubwin.visualstudio.com/windows-uwp/_git/winrt-api into docs

Author: QuinnRadich

docfx.json

@@ -46,13 +46,13 @@
        "author": "GrantMeStrength",
        "ms.author": "jken",
        "extendBreadcrumb": true,
-       "ms.prod": "uwp",
+       "ms.service": "uwp",
        "products": [
        "https://authoring-docs-microsoft.poolparty.biz/devrel/caec7b7f-4941-4578-b79f-c63b1c1f5af4",   
        "https://authoring-docs-microsoft.poolparty.biz/devrel/e0ffb20c-01c6-407b-a9bd-29111652a1dc",
        "https://authoring-docs-microsoft.poolparty.biz/devrel/e9b7979e-fb8b-40a7-a19f-c987950324dc"
        ],
-       "ms.technology": "winrt-reference",
+       "ms.subservice": "winrt-reference",
        "ms.topic": "managed-reference",
        "ms.date": "02/08/2017",
        "keywords": "windows 10, uwp, winrt, api",

windows.devices.sensors/magnetometeraccuracy.md

@@ -10,14 +10,15 @@ public enum Windows.Devices.Sensors.MagnetometerAccuracy : int
 # MagnetometerAccuracy
 
 ## -description
-The sensor's accuracy.
 
-This short video gives an overview of how to calibrate the magnetometer's accuracy.
+The sensor's accuracy.
 
-<video />
+See [One Dev Minute - Sensor calibration](https://learn.microsoft.com/shows/one-dev-minute/sensor-calibration) for a short video overview on how to calibrate the magnetometer.
 
 ## -enum-fields
+
 ### -field Unknown:0
+
 The accuracy is currently not available, typically because the driver can't report it.
 
 You should determine, based on your app's needs, whether your app will want to ask users to calibrate the device whenever this value is returned.

windows.globalization.datetimeformatting/datetimeformatter_template.md

@@ -10,14 +10,17 @@ public string Template { get; }
 # Windows.Globalization.DateTimeFormatting.DateTimeFormatter.Template
 
 ## -description
+
 Gets a string representation of this format template.
 
 ## -property-value
+
 A string that represents this format template. If the [DateTimeFormatter](datetimeformatter.md) object was constructed with a format template or format enumerations, the string can be used to construct the same [DateTimeFormatter](datetimeformatter.md). If a pattern was used to construct the [DateTimeFormatter](datetimeformatter.md), this property returns the empty string. See the remarks for the [DateTimeFormatter](datetimeformatter.md) class for a list of valid format templates.
 
 ## -remarks
 
 ## -examples
 
 ## -see-also
-[Date and time formatting sample](/samples/browse/)
+
+[Date and time formatting sample](/samples/microsoft/windows-universal-samples/datetimeformatting/)

windows.networking.connectivity/networkconnectivitylevel.md

@@ -22,14 +22,15 @@ Local network access only.
 ### -field ConstrainedInternetAccess:2
 Limited internet access.
 
-This value indicates captive portal connectivity, where local access to a web portal is provided, but access to the Internet requires that specific credentials are provided via the portal. This level of connectivity is generally encountered when using connections hosted in public locations (for example, coffee shops and book stores).
+This value is an indication that the connection is constrained, possibly due to a captive portal. Or possibly due to some other reason; for example, a proxy between the client and the internet that's modifying the HTTP header in some unknown way. In the case of captive portal connectivity, local access to a web portal is provided, but access to the internet requires that specific credentials are provided via the portal.
+
+This level of connectivity (limited internet access) is generally encountered when using connections hosted in public locations (for example, coffee shops and book stores).
 
 > [!NOTE]
-> This doesn't guarantee detection of a captive portal. UWP apps should also test if the captive portal can be reached using a URL for the captive portal, or by attempting access to a public web site which will then redirect to the captive portal when Windows reports **LocalAccess** as the current NetworkConnectivityLevel.
+> As mentioned, this doesn't necessarily mean that a captive portal has been detected. You should also test whether the captive portal can be reached by using a URL for the captive portal, or by attempting access to a public web site, which will then redirect to the captive portal when Windows reports **LocalAccess** as the current NetworkConnectivityLevel.
 
 ### -field InternetAccess:3
-Local and Internet access.
-
+Local and internet access.
 
 ## -remarks
 For an example of how these values are used to indicate connection changes, see [Quickstart: Managing connection events and changes in availability](/previous-versions/windows/apps/hh700376(v=win.10)).

windows.security.authorization.appcapabilityaccess/appcapability_displaymessage.md

@@ -17,7 +17,7 @@ The purpose of why the capability is being accessed.
 The stored display message as a string property.
 
 ## -remarks
-The display message, if specified, appears in the system tray and settings app under **Privacy & security > App permissions** pages while the capability is in use.
+The display message, if specified, appears in the system tray and settings app under **Privacy & security > App permissions** pages while the capability is in use. Display messages should be provided before the capability is accessed and should continue to be provided until after the apps terminate access to the capability.
 
 ## -see-also
 

windows.system.profile/platformautomaticappsigninmanager.md

@@ -0,0 +1,21 @@
+---
+-api-id: T:Windows.System.Profile.PlatformAutomaticAppSignInManager
+-api-type: winrt class
+---
+
+<!-- Class syntax.
+public static class PlatformAutomaticAppSignInManager 
+-->
+
+# Windows.System.Profile.PlatformAutomaticAppSignInManager
+
+## -description
+Provides information about the current Windows policy for automatic app sign in.
+
+## -remarks
+> [!IMPORTANT]
+> This class is intended for use by first-party applications.
+
+## -see-also
+
+## -examples

windows.system.profile/platformautomaticappsigninmanager_policy.md

@@ -0,0 +1,24 @@
+---
+-api-id: P:Windows.System.Profile.PlatformAutomaticAppSignInManager.Policy
+-api-type: winrt property
+---
+
+<!-- Property syntax.
+public static Windows.System.Profile.PlatformAutomaticAppSignInPolicy Policy { get; }
+-->
+
+# Windows.System.Profile.PlatformAutomaticAppSignInManager.Policy
+
+## -description
+The Windows policy for automatic app sign in.
+
+## -property-value
+
+## -remarks
+> [!IMPORTANT]
+> This method is intended for use by first-party applications.
+
+## -see-also
+[PlatformAutomaticAppSignInPolicy](platformautomaticappsigninpolicy_platformautomaticappsigninpolicy.md)
+
+## -examples

windows.system.profile/platformautomaticappsigninpolicy_platformautomaticappsigninpolicy.md

@@ -0,0 +1,34 @@
+---
+-api-id: T:Windows.System.Profile.PlatformAutomaticAppSignInPolicy
+-api-type: winrt enum
+---
+
+<!--
+public enum PlatformAutomaticAppSignInPolicy
+-->
+
+# Windows.System.Profile.PlatformAutomaticAppSignInPolicy
+
+## -description
+Defines state that specify the current stage for automatic app sign in.
+
+## -enum-fields
+
+### -field Unknown: 0
+
+This policy cannot be evaluated
+
+### -field PermissionRequired: 1
+
+Do not sign in automatically
+
+### -field AlwaysAllowed: 2
+
+Sign in automatically
+
+## -remarks
+> [!IMPORTANT]
+> This enum is intended for use by first-party applications.
+
+## -see-also
+[Policy](platformautomaticappsigninmanager_policy.md)

windows.ui.core/pointereventargs.md

@@ -70,4 +70,4 @@ void MyCoreWindowEvents::SetWindow( // implementation called by CoreApplication:
 ```
 
 ## -see-also
-[Input: Manipulations and gestures (C++) sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/Input%20Gestures%20and%20manipulations%20with%20GestureRecognizer), [Input: Simplified ink  sample](/samples/browse/), [Input: Touch hit testing sample](/samples/browse/)
+[Input: Manipulations and gestures (C++) sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/Input%20Gestures%20and%20manipulations%20with%20GestureRecognizer), [Input: Simplified ink  sample](/samples/microsoft/windows-universal-samples/simpleink/), [Input: Touch hit testing sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%2B%2B%5D-Windows%208%20app%20samples/C%2B%2B/Windows%208%20app%20samples/Input%20Touch%20hit%20testing%20sample%20(Windows%208)/C%2B%2B)

windows.ui.input/crossslidingeventargs.md

@@ -29,4 +29,4 @@ Contains event data for the [CrossSliding](gesturerecognizer_crosssliding.md) ev
 ## -examples
 
 ## -see-also
-[Windows.UI.Input Classes](windows_ui_input_classes.md), [Windows.Devices.Input](../windows.devices.input/windows_devices_input.md), [Windows.UI.Core](../windows.ui.core/windows_ui_core.md), [Windows.UI.Input](windows_ui_input.md), [Windows.UI.Input.Inking](../windows.ui.input.inking/windows_ui_input_inking.md), [Windows.UI.Xaml.Input](../windows.ui.xaml.input/windows_ui_xaml_input.md), [TypedEventHandler](../windows.foundation/typedeventhandler_2.md), [Custom user interactions](/windows/uwp/design/layout/index), [UX guidelines for custom user interactions](/windows/uwp/design/layout/index), [Touch design guidelines](/windows/uwp/input-and-devices/guidelines-for-user-interaction), [User interaction mode sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/UserInteractionMode), [Focus visuals sample](https://go.microsoft.com/fwlink/p/?LinkID=619895), [Input: Device capabilities sample](/samples/browse/), [Input: Ink sample](/samples/browse/), [Input: Manipulations and gestures (JavaScript) sample](/samples/browse/), [Input: Simplified ink  sample](/samples/browse/), [Input: Windows 8 gestures sample](/samples/browse/), [Input: XAML user input events sample](/samples/browse/), [XAML scrolling, panning, and zooming sample](/samples/browse/), [DirectX touch input sample](/samples/browse/), [Input: Manipulations and gestures (C++) sample](/samples/browse/), [Input: Touch hit testing sample](/samples/browse/), [Input source identification sample](/samples/browse/), [Touch injection sample](/samples/browse/), [Win32 touch hit-testing sample](/samples/browse/)
+[Windows.UI.Input Classes](windows_ui_input_classes.md), [Windows.Devices.Input](../windows.devices.input/windows_devices_input.md), [Windows.UI.Core](../windows.ui.core/windows_ui_core.md), [Windows.UI.Input](windows_ui_input.md), [Windows.UI.Input.Inking](../windows.ui.input.inking/windows_ui_input_inking.md), [Windows.UI.Xaml.Input](../windows.ui.xaml.input/windows_ui_xaml_input.md), [TypedEventHandler](../windows.foundation/typedeventhandler_2.md), [Custom user interactions](/windows/uwp/design/layout/index), [UX guidelines for custom user interactions](/windows/uwp/design/layout/index), [Touch design guidelines](/windows/uwp/input-and-devices/guidelines-for-user-interaction), [User interaction mode sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/UserInteractionMode), [Focus visuals sample](https://go.microsoft.com/fwlink/p/?LinkID=619895), [Input: Device capabilities sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/411c271e537727d737a53fa2cbe99eaecac00cc0/Official%20Windows%20Platform%20Sample/Input%20Device%20capabilities%20sample), [Input: Simplified ink  sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Input%20Simplified%20ink%20sample), [Input: Windows 8 gestures sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%23%5D-Windows%208%20app%20samples/C%23/Windows%208%20app%20samples/Input%20Windows%208%20gestures%20sample%20(Windows%208)/C%23), [Input: XAML user input events sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Input%20XAML%20user%20input%20events%20sample), [XAML scrolling, panning, and zooming sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/XAML%20scrolling%2C%20panning%2C%20and%20zooming%20sample), [DirectX touch input sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%2B%2B%5D-Windows%208%20app%20samples/C%2B%2B/Windows%208%20app%20samples/DirectX%20touch%20input%20sample%20(Windows%208)/C%2B%2B), [Input: Manipulations and gestures (C++) sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%2B%2B%5D-Windows%208%20app%20samples/C%2B%2B/Windows%208%20app%20samples/Input%20Manipulations%20and%20gestures%20(C%2B%2B)%20sample%20(Windows%208)/C%2B%2B), [Input: Touch hit testing sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%2B%2B%5D-Windows%208%20app%20samples/C%2B%2B/Windows%208%20app%20samples/Input%20Touch%20hit%20testing%20sample%20(Windows%208)/C%2B%2B), [Input source identification sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Windows%208%20desktop%20samples/%5BC%2B%2B%5D-Windows%208%20desktop%20samples/C%2B%2B/Windows%208%20desktop%20samples/Input%20Source%20identification%20sample/C%2B%2B), [Touch injection sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Input%20Touch%20injection%20sample), [Win32 touch hit-testing sample](https://github.com/microsoftarchive/msdn-code-gallery-microsoft/tree/21cb9b6bc0da3b234c5854ecac449cb3bd261f29/Official%20Windows%20Platform%20Sample/Windows%208%20app%20samples/%5BC%2B%2B%5D-Windows%208%20app%20samples/C%2B%2B/Windows%208%20app%20samples/Input%20Touch%20hit%20testing%20sample%20(Windows%208)/C%2B%2B)