From 52a0f4c8ab7187c88fcc32c706829feaf2012d8a Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sun, 16 Aug 2026 21:27:43 -0500
Subject: [PATCH 1/2] Document Photo Picker parcelable APIs

Refs #215

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../EmbeddedPhotoPickerFeatureInfo.xml        | 42 +++++++++++++++++--
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml
index 1d7c5eec6..25ec5e80c 100644
--- a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml
+++ b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml
@@ -134,6 +134,18 @@
       <Docs>
         <summary>Creates <c>EmbeddedPhotoPickerFeatureInfo</c> instances from a <c>Parcel</c>.</summary>
         <value>A <c>Parcelable.Creator</c> for <c>EmbeddedPhotoPickerFeatureInfo</c>.</value>
+        <remarks>
+          <para>
+            <format type="text/html">
+              <a href="https://developer.android.com/reference/android/os/Parcelable" title="Reference documentation">Java documentation for <code>android.os.Parcelable</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="DescribeContents">
@@ -164,8 +176,20 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Describes the special objects contained in this parcelable's marshaled representation.</summary>
-        <returns>A bitmask of the special object types in the marshaled representation, or <c>0</c>.</returns>
+        <summary>Reports no special objects in this parcelable's marshaled representation.</summary>
+        <returns><c>0</c>.</returns>
+        <remarks>
+          <para>
+            <format type="text/html">
+              <a href="https://android.googlesource.com/platform/packages/providers/MediaProvider/+/refs/heads/main/photopicker/framework/java/android/widget/photopicker/EmbeddedPhotoPickerFeatureInfo.java" title="Source documentation">Android Open Source Project source for <code>EmbeddedPhotoPickerFeatureInfo.describeContents()</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="IsOrderedSelection">
@@ -498,7 +522,19 @@
       <Docs>
         <param name="dest">The <c>Parcel</c> in which to write this object.</param>
         <param name="flags">Additional flags controlling how to write this object.</param>
-        <summary>Flattens this object into a <c>Parcel</c>.</summary>
+        <summary>Writes the configured picker features to a <c>Parcel</c>.</summary>
+        <remarks>
+          <para>
+            <format type="text/html">
+              <a href="https://android.googlesource.com/platform/packages/providers/MediaProvider/+/refs/heads/main/photopicker/framework/java/android/widget/photopicker/EmbeddedPhotoPickerFeatureInfo.java" title="Source documentation">Android Open Source Project source for <code>EmbeddedPhotoPickerFeatureInfo.writeToParcel(Parcel, 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>
   </Members>

From aa30c014ac5b0d5d72a9dfeab5a14180633570d0 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sun, 16 Aug 2026 21:48:46 -0500
Subject: [PATCH 2/2] Correct Photo Picker creator reference

Refs #215

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../EmbeddedPhotoPickerFeatureInfo.xml                          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml
index 25ec5e80c..bd8d21511 100644
--- a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml
+++ b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml
@@ -137,7 +137,7 @@
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/os/Parcelable" title="Reference documentation">Java documentation for <code>android.os.Parcelable</code>.</a>
+              <a href="https://developer.android.com/reference/android/os/Parcelable.Creator" title="Reference documentation">Java documentation for <code>android.os.Parcelable.Creator</code>.</a>
             </format>
           </para>
           <para>