From c045461ad53a23e4387efae373903fe63668ee6b Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 09:38:40 -0500
Subject: [PATCH 1/3] Document AndroidMessageHandler redirects

Refs #278

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../AndroidMessageHandler.xml                    | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml b/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
index f1df810c8..87109684b 100644
--- a/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
+++ b/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
@@ -85,9 +85,10 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>
+          Gets or sets a value that indicates whether the handler should follow redirection responses.
+          The default value is <c>true</c>.
+        </summary>
       </Docs>
     </Member>
     <Member MemberName="AssertSelf">
@@ -934,9 +935,12 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>
+          Gets a value indicating whether the handler supports configuration settings for the
+          <see cref="P:Xamarin.Android.Net.AndroidMessageHandler.AllowAutoRedirect" /> and
+          <see cref="P:Xamarin.Android.Net.AndroidMessageHandler.MaxAutomaticRedirections" /> properties.
+          Always returns <c>true</c> for <see cref="T:Xamarin.Android.Net.AndroidMessageHandler" />.
+        </summary>
       </Docs>
     </Member>
     <Member MemberName="TrustedCerts">

From 4dacab65cc795413679f32063ef8e115aedf9f3d Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 09:49:40 -0500
Subject: [PATCH 2/3] Address redirect documentation review

Refs #278

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../AndroidMessageHandler.xml                 | 20 +++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml b/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
index 87109684b..e438871a7 100644
--- a/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
+++ b/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
@@ -86,9 +86,13 @@
       </ReturnValue>
       <Docs>
         <summary>
-          Gets or sets a value that indicates whether the handler should follow redirection responses.
-          The default value is <c>true</c>.
+          Controls whether the handler follows HTTP redirect responses. The default value is <c>true</c>.
         </summary>
+        <value><c>true</c> to follow redirect responses; otherwise, <c>false</c>.</value>
+        <remarks>
+          <para>See <see cref="P:Java.Net.HttpURLConnection.InstanceFollowRedirects" /> for the
+          Java connection redirect-following setting.</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="AssertSelf">
@@ -936,11 +940,15 @@
       </ReturnValue>
       <Docs>
         <summary>
-          Gets a value indicating whether the handler supports configuration settings for the
-          <see cref="P:Xamarin.Android.Net.AndroidMessageHandler.AllowAutoRedirect" /> and
-          <see cref="P:Xamarin.Android.Net.AndroidMessageHandler.MaxAutomaticRedirections" /> properties.
-          Always returns <c>true</c> for <see cref="T:Xamarin.Android.Net.AndroidMessageHandler" />.
+          Indicates support for configuring <see cref="P:Xamarin.Android.Net.AndroidMessageHandler.AllowAutoRedirect" />
+          and <see cref="P:Xamarin.Android.Net.AndroidMessageHandler.MaxAutomaticRedirections" />. This handler always
+          supports both settings.
         </summary>
+        <value><c>true</c>.</value>
+        <remarks>
+          <para>See <see cref="P:Java.Net.HttpURLConnection.InstanceFollowRedirects" /> for the
+          Java connection redirect-following setting.</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="TrustedCerts">

From 013e4a23ea7b7bc7df0b3d59ea960dd755719c26 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sun, 16 Aug 2026 08:36:55 -0500
Subject: [PATCH 3/3] Clarify managed redirect handling

Refs #278

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml b/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
index e438871a7..ed7b40452 100644
--- a/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
+++ b/docs/xml/Xamarin.Android.Net/AndroidMessageHandler.xml
@@ -90,8 +90,8 @@
         </summary>
         <value><c>true</c> to follow redirect responses; otherwise, <c>false</c>.</value>
         <remarks>
-          <para>See <see cref="P:Java.Net.HttpURLConnection.InstanceFollowRedirects" /> for the
-          Java connection redirect-following setting.</para>
+          <para>The handler disables automatic redirect following for each underlying
+          <see cref="T:Java.Net.HttpURLConnection" /> and processes redirect responses itself.</para>
         </remarks>
       </Docs>
     </Member>
@@ -946,8 +946,8 @@
         </summary>
         <value><c>true</c>.</value>
         <remarks>
-          <para>See <see cref="P:Java.Net.HttpURLConnection.InstanceFollowRedirects" /> for the
-          Java connection redirect-following setting.</para>
+          <para>Redirect configuration applies to the handler's managed redirect processing rather than to automatic
+          redirect handling by the underlying <see cref="T:Java.Net.HttpURLConnection" />.</para>
         </remarks>
       </Docs>
     </Member>