Merge main to live

.openpublishing.publish.config.json

@@ -60,7 +60,7 @@
     {
       "path_to_root": "_themes",
       "url": "https://github.com/Microsoft/templates.docs.msft",
-      "branch": "master",
+      "branch": "main",
       "branch_mapping": {}
     }
   ],

docs/Mono.Android/en/Android.AccessibilityServices/AccessibilityButtonController+AccessibilityButtonCallback.xml

@@ -18,14 +18,19 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Callback for interaction with and changes to state of the accessibility button
+            within the system's navigation area.</summary>
     <remarks>
       <para>
         <format type="text/html">
-          <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityButtonController$AccessibilityButtonCallback" title="Reference documentation">Android platform documentation</a>
+          <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityButtonController.AccessibilityButtonCallback" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityButtonController.AccessibilityButtonCallback</code>.</a>
         </format>
       </para>
-      <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+      <para>
+                    Portions of this page are modifications based on work created and shared by the 
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the 
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
     </remarks>
   </Docs>
   <Members>
@@ -130,11 +135,23 @@
         <Parameter Name="available" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <param name="controller">To be added.</param>
-        <param name="available">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="controller">the controller used to register for this callback</param>
+        <param name="available">
+          <c>true</c> if the accessibility button is available to this
+                             service, <c>false</c> otherwise</param>
+        <summary>Called when the availability of the accessibility button in the system's
+            navigation area has changed.</summary>
         <remarks>
-          <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityButtonController.AccessibilityButtonCallback#onAvailabilityChanged(android.accessibilityservice.AccessibilityButtonController,%20boolean)" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityButtonController.AccessibilityButtonCallback.onAvailabilityChanged(android.accessibilityservice.AccessibilityButtonController, boolean)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the 
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the 
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
       </Docs>
     </Member>
@@ -161,10 +178,19 @@
         <Parameter Name="controller" Type="Android.AccessibilityServices.AccessibilityButtonController" />
       </Parameters>
       <Docs>
-        <param name="controller">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="controller">the controller used to register for this callback</param>
+        <summary>Called when the accessibility button in the system's navigation area is clicked.</summary>
         <remarks>
-          <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityButtonController.AccessibilityButtonCallback#onClicked(android.accessibilityservice.AccessibilityButtonController)" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityButtonController.AccessibilityButtonCallback.onClicked(android.accessibilityservice.AccessibilityButtonController)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the 
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the 
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
       </Docs>
     </Member>

docs/Mono.Android/en/Android.AccessibilityServices/AccessibilityButtonController.xml

@@ -167,8 +167,8 @@
         <Parameter Name="handler" Type="Android.OS.Handler" />
       </Parameters>
       <Docs>
-        <param name="handler">To be added.</param>
         <param name="callback">the callback to add, must be non-null</param>
+        <param name="handler">To be added.</param>
         <summary>Registers the provided <c>AccessibilityButtonCallback</c> for interaction and state
             changes callbacks related to the accessibility button.</summary>
         <remarks>

docs/Mono.Android/en/Android.AccessibilityServices/AccessibilityGestureEvent.xml

@@ -107,7 +107,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>[TODO: @inheritDoc]</summary>
+        <summary>To be added</summary>
         <returns>To be added.</returns>
         <remarks>
           <para>

docs/Mono.Android/en/Android.AccessibilityServices/AccessibilityService+GestureResultCallback.xml

@@ -18,14 +18,18 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Class used to report status of dispatched gestures</summary>
     <remarks>
       <para>
         <format type="text/html">
-          <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService$GestureResultCallback" title="Reference documentation">Android platform documentation</a>
+          <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService.GestureResultCallback" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.GestureResultCallback</code>.</a>
         </format>
       </para>
-      <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+      <para>
+                    Portions of this page are modifications based on work created and shared by the 
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the 
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
     </remarks>
   </Docs>
   <Members>
@@ -129,10 +133,19 @@
         <Parameter Name="gestureDescription" Type="Android.AccessibilityServices.GestureDescription" />
       </Parameters>
       <Docs>
-        <param name="gestureDescription">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="gestureDescription">The description of the gesture that was cancelled.</param>
+        <summary>Called when the gesture was cancelled</summary>
         <remarks>
-          <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService.GestureResultCallback#onCancelled(android.accessibilityservice.GestureDescription)" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.GestureResultCallback.onCancelled(android.accessibilityservice.GestureDescription)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the 
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the 
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
       </Docs>
     </Member>
@@ -159,10 +172,19 @@
         <Parameter Name="gestureDescription" Type="Android.AccessibilityServices.GestureDescription" />
       </Parameters>
       <Docs>
-        <param name="gestureDescription">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="gestureDescription">The description of the gesture that completed.</param>
+        <summary>Called when the gesture has completed successfully</summary>
         <remarks>
-          <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService.GestureResultCallback#onCompleted(android.accessibilityservice.GestureDescription)" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.GestureResultCallback.onCompleted(android.accessibilityservice.GestureDescription)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the 
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the 
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
       </Docs>
     </Member>

docs/Mono.Android/en/Android.AccessibilityServices/AccessibilityService+ITakeScreenshotCallback.xml

@@ -25,8 +25,19 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Interface used to report status of taking screenshot.</summary>
+    <remarks>
+      <para>
+        <format type="text/html">
+          <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService.TakeScreenshotCallback" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.TakeScreenshotCallback</code>.</a>
+        </format>
+      </para>
+      <para>
+                    Portions of this page are modifications based on work created and shared by the 
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the 
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="OnFailure">
@@ -52,9 +63,20 @@
         <Parameter Name="errorCode" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="errorCode">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="errorCode">The error code of this operation.</param>
+        <summary>Called when taking screenshot has failed.</summary>
+        <remarks>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService.TakeScreenshotCallback#onFailure(int)" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.TakeScreenshotCallback.onFailure(int)</code>.</a>
+            </format>
+          </para>
+          <para>
+                    Portions of this page are modifications based on work created and shared by the 
+                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
+                     and used according to terms described in the 
+                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="OnSuccess">