From 1f8b15404ad8442ae375f8c7a59b8a6000a1f387 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 11:41:48 -0500
Subject: [PATCH 1/2] Document PatternPathMotion XML construction

Refs #212

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../Android.Transitions/PatternPathMotion.xml   | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/docs/xml/Android.Transitions/PatternPathMotion.xml b/docs/xml/Android.Transitions/PatternPathMotion.xml
index 4c1a4edb8..f3f624e28 100644
--- a/docs/xml/Android.Transitions/PatternPathMotion.xml
+++ b/docs/xml/Android.Transitions/PatternPathMotion.xml
@@ -141,13 +141,14 @@
         <Parameter Name="attrs" Type="Android.Util.IAttributeSet" />
       </Parameters>
       <Docs>
-        <param name="context">To be added.</param>
-        <param name="attrs">To be added.</param>
-        <summary>Constructs a PatternPathMotion with a straight-line pattern.</summary>
+        <param name="context">The context used to obtain the PatternPathMotion style attributes.</param>
+        <param name="attrs">The XML attributes. The <c>android:patternPathData</c> attribute is required.</param>
+        <summary>Constructs a PatternPathMotion from XML attributes.</summary>
         <remarks>
+          <para>The <c>android:patternPathData</c> attribute supplies the pattern path.</para>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/transition/PatternPathMotion#PatternPathMotion()" title="Reference documentation">Java documentation for <code>android.transition.PatternPathMotion.PatternPathMotion()</code>.</a>
+              <a href="https://android.googlesource.com/platform/frameworks/base/+/refs/heads/main/core/java/android/transition/PatternPathMotion.java" title="Source documentation">Android Open Source Project source for <code>android.transition.PatternPathMotion</code>.</a>
             </format>
           </para>
           <para>
@@ -213,8 +214,14 @@
         <param name="endY">The y coordinate of the ending point.</param>
         <summary>Provide a Path to interpolate between two points <c>(startX, startY)</c> and
  <c>(endX, endY)</c>.</summary>
-        <returns>To be added.</returns>
+        <returns>A Path along which the points are interpolated. The returned path starts at
+<c>(startX, startY)</c> and ends at <c>(endX, endY)</c>.</returns>
         <remarks>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/transition/PatternPathMotion#getPath(float,%20float,%20float,%20float)" title="Reference documentation">Java documentation for <code>android.transition.PatternPathMotion.getPath(float, float, float, float)</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>

From 2ccc326643ccbf63d04c38903ffabee427f1ccf9 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 11:52:40 -0500
Subject: [PATCH 2/2] Address PatternPathMotion review feedback

Refs #212

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Android.Transitions/PatternPathMotion.xml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/xml/Android.Transitions/PatternPathMotion.xml b/docs/xml/Android.Transitions/PatternPathMotion.xml
index f3f624e28..2819bb4d5 100644
--- a/docs/xml/Android.Transitions/PatternPathMotion.xml
+++ b/docs/xml/Android.Transitions/PatternPathMotion.xml
@@ -148,7 +148,12 @@
           <para>The <c>android:patternPathData</c> attribute supplies the pattern path.</para>
           <para>
             <format type="text/html">
-              <a href="https://android.googlesource.com/platform/frameworks/base/+/refs/heads/main/core/java/android/transition/PatternPathMotion.java" title="Source documentation">Android Open Source Project source for <code>android.transition.PatternPathMotion</code>.</a>
+              <a href="https://developer.android.com/reference/android/transition/PatternPathMotion" title="Reference documentation">Java documentation for <code>android.transition.PatternPathMotion</code>.</a>
+            </format>
+          </para>
+          <para>
+            <format type="text/html">
+              <a href="https://android.googlesource.com/platform/frameworks/base/+/refs/heads/main/core/java/android/transition/PatternPathMotion.java" title="Android Open Source Project source">Android Open Source Project source for XML-constructor behavior.</a>
             </format>
           </para>
           <para>