From 5ff0c74747c6fc190461b82b0afb7010517898c1 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Jul 2026 02:32:22 +0000
Subject: [PATCH 1/2] Initial plan


From 07567f7cc059225f2d584c7e5da5f273c12196fe Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Jul 2026 02:58:53 +0000
Subject: [PATCH 2/2] Add XML documentation to generic FragmentManager helper
 methods

Co-authored-by: jonathanpeppers <840039+jonathanpeppers@users.noreply.github.com>
---
 .../Android.App/FragmentManager.cs            | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/src/Mono.Android/Android.App/FragmentManager.cs b/src/Mono.Android/Android.App/FragmentManager.cs
index b6f421c9b91..5d8500a9130 100644
--- a/src/Mono.Android/Android.App/FragmentManager.cs
+++ b/src/Mono.Android/Android.App/FragmentManager.cs
@@ -5,6 +5,17 @@
 #if ANDROID_11
 namespace Android.App {
 	public partial class FragmentManager {
+		/// <summary>
+		/// Finds a <see cref="Fragment"/> that was identified by the given id, either when
+		/// inflated from XML or as the container id when added in a transaction, and returns
+		/// it cast to <typeparamref name="T"/>.
+		/// </summary>
+		/// <typeparam name="T">The <see cref="Fragment"/> type to cast the result to.</typeparam>
+		/// <param name="id">The resource id or container id used to identify the fragment.</param>
+		/// <returns>
+		/// The matching fragment cast to <typeparamref name="T"/>, or <see langword="null"/>
+		/// if no matching fragment exists.
+		/// </returns>
 		public T? FindFragmentById<
 				[DynamicallyAccessedMembers (Constructors)]
 				T
@@ -14,6 +25,17 @@ public T? FindFragmentById<
 			return FindFragmentById (id).JavaCast<T> ();
 		}
 
+		/// <summary>
+		/// Finds a <see cref="Fragment"/> that was identified by the given tag, either when
+		/// inflated from XML or as supplied when added in a transaction, and returns it cast
+		/// to <typeparamref name="T"/>.
+		/// </summary>
+		/// <typeparam name="T">The <see cref="Fragment"/> type to cast the result to.</typeparam>
+		/// <param name="tag">The tag used to identify the fragment.</param>
+		/// <returns>
+		/// The matching fragment cast to <typeparamref name="T"/>, or <see langword="null"/>
+		/// if no matching fragment exists.
+		/// </returns>
 		public T? FindFragmentByTag<
 				[DynamicallyAccessedMembers (Constructors)]
 				T
@@ -23,6 +45,18 @@ public T? FindFragmentByTag<
 			return FindFragmentByTag (tag).JavaCast<T> ();
 		}
 
+		/// <summary>
+		/// Retrieves the current <see cref="Fragment"/> instance for a reference previously
+		/// placed in <paramref name="bundle"/> with <c>PutFragment</c>, and returns it cast
+		/// to <typeparamref name="T"/>.
+		/// </summary>
+		/// <typeparam name="T">The <see cref="Fragment"/> type to cast the result to.</typeparam>
+		/// <param name="bundle">The bundle in which the fragment reference was stored.</param>
+		/// <param name="key">The name of the entry in the bundle.</param>
+		/// <returns>
+		/// The referenced fragment cast to <typeparamref name="T"/>, or <see langword="null"/>
+		/// if no fragment is associated with the given key.
+		/// </returns>
 		public T? GetFragment<
 				[DynamicallyAccessedMembers (Constructors)]
 				T