From 8135b2231897669637d5e05c33a4ee9dac2af914 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Fri, 14 Aug 2026 03:59:06 -0500
Subject: [PATCH 1/2] Document Android.Window back events

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Android.Window/BackEvent.xml     | 10 +++++-----
 docs/xml/Android.Window/BackEventEdge.xml | 17 ++++++++++++-----
 2 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/docs/xml/Android.Window/BackEvent.xml b/docs/xml/Android.Window/BackEvent.xml
index 87e60cc91..b951a97fe 100644
--- a/docs/xml/Android.Window/BackEvent.xml
+++ b/docs/xml/Android.Window/BackEvent.xml
@@ -316,7 +316,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the frameTime of the BackEvent in milliseconds.</summary>
-        <value>To be added.</value>
+        <value>The frame time of this event, in milliseconds.</value>
         <remarks>
           <para>Returns the frameTime of the BackEvent in milliseconds. Useful for calculating velocity.</para>
           <para>
@@ -386,7 +386,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns a value between 0 and 1 on how far along the back gesture is.</summary>
-        <value>To be added.</value>
+        <value>A value from 0.0f to 1.0f, inclusive, representing the back gesture's progress.</value>
         <remarks>
           <para>Returns a value between 0 and 1 on how far along the back gesture is. This value is
             driven by the horizontal location of the touch point, and should be used as the fraction to
@@ -441,7 +441,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the screen edge that the swipe starts from.</summary>
-        <value>To be added.</value>
+        <value>The screen edge from which the swipe begins.</value>
         <remarks>
           <para>Returns the screen edge that the swipe starts from.</para>
           <para>
@@ -541,7 +541,7 @@
       <Docs>
         <summary>Returns the absolute X location of the touch point, or NaN if the event is from
             a button press.</summary>
-        <value>To be added.</value>
+        <value>The absolute X location of the touch point, or <see langword="NaN" /> for a button press.</value>
         <remarks>
           <para>Returns the absolute X location of the touch point, or NaN if the event is from
             a button press.</para>
@@ -584,7 +584,7 @@
       <Docs>
         <summary>Returns the absolute Y location of the touch point, or NaN if the event is from
             a button press.</summary>
-        <value>To be added.</value>
+        <value>The absolute Y location of the touch point, or <see langword="NaN" /> for a button press.</value>
         <remarks>
           <para>Returns the absolute Y location of the touch point, or NaN if the event is from
             a button press.</para>
diff --git a/docs/xml/Android.Window/BackEventEdge.xml b/docs/xml/Android.Window/BackEventEdge.xml
index 9cdf41d01..88c22b24b 100644
--- a/docs/xml/Android.Window/BackEventEdge.xml
+++ b/docs/xml/Android.Window/BackEventEdge.xml
@@ -11,8 +11,15 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Defines the edge from which a back swipe begins.</summary>
+    <remarks>
+      <para>The values correspond to the edge constants reported by <c>BackEvent</c>.</para>
+      <para>
+        <format type="text/html">
+          <a href="https://developer.android.com/reference/android/window/BackEvent" title="Reference documentation">Java documentation for <code>android.window.BackEvent</code>.</a>
+        </format>
+      </para>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="Left">
@@ -40,7 +47,7 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The back swipe begins at the left edge of the screen.</summary>
       </Docs>
     </Member>
     <Member MemberName="None">
@@ -68,7 +75,7 @@
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The back event did not begin as an edge swipe, such as when invoked by 3-button navigation or a hardware back button.</summary>
       </Docs>
     </Member>
     <Member MemberName="Right">
@@ -96,7 +103,7 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The back swipe begins at the right edge of the screen.</summary>
       </Docs>
     </Member>
   </Members>

From 8456bf15ea2151f3894449bd19d61dfe9655a1c6 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Fri, 14 Aug 2026 04:10:08 -0500
Subject: [PATCH 2/2] Address Android Window docs review

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Android.Window/BackEvent.xml     | 4 ++--
 docs/xml/Android.Window/BackEventEdge.xml | 5 +++++
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/docs/xml/Android.Window/BackEvent.xml b/docs/xml/Android.Window/BackEvent.xml
index b951a97fe..ad930ee00 100644
--- a/docs/xml/Android.Window/BackEvent.xml
+++ b/docs/xml/Android.Window/BackEvent.xml
@@ -541,7 +541,7 @@
       <Docs>
         <summary>Returns the absolute X location of the touch point, or NaN if the event is from
             a button press.</summary>
-        <value>The absolute X location of the touch point, or <see langword="NaN" /> for a button press.</value>
+        <value>The absolute X location of the touch point, or <c>NaN</c> for a button press.</value>
         <remarks>
           <para>Returns the absolute X location of the touch point, or NaN if the event is from
             a button press.</para>
@@ -584,7 +584,7 @@
       <Docs>
         <summary>Returns the absolute Y location of the touch point, or NaN if the event is from
             a button press.</summary>
-        <value>The absolute Y location of the touch point, or <see langword="NaN" /> for a button press.</value>
+        <value>The absolute Y location of the touch point, or <c>NaN</c> for a button press.</value>
         <remarks>
           <para>Returns the absolute Y location of the touch point, or NaN if the event is from
             a button press.</para>
diff --git a/docs/xml/Android.Window/BackEventEdge.xml b/docs/xml/Android.Window/BackEventEdge.xml
index 88c22b24b..98bae5e95 100644
--- a/docs/xml/Android.Window/BackEventEdge.xml
+++ b/docs/xml/Android.Window/BackEventEdge.xml
@@ -19,6 +19,11 @@
           <a href="https://developer.android.com/reference/android/window/BackEvent" title="Reference documentation">Java documentation for <code>android.window.BackEvent</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>