From 36b0405ec0bf0b3b9f95cfd28a998a279a380a3f Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Fri, 14 Aug 2026 05:50:32 -0500
Subject: [PATCH] Document Android view inspectors

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 ...anionUninitializedPropertyMapException.xml |  4 ++--
 .../IntFlagMapping.xml                        |  4 ++--
 ...ropertyMapperPropertyConflictException.xml | 10 ++++-----
 ...rtyReaderPropertyTypeMismatchException.xml | 22 +++++++++----------
 .../StaticInspectionCompanionProvider.xml     | 12 +++++-----
 .../WindowInspector.xml                       |  2 +-
 6 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/docs/xml/Android.Views.Inspectors/InspectionCompanionUninitializedPropertyMapException.xml b/docs/xml/Android.Views.Inspectors/InspectionCompanionUninitializedPropertyMapException.xml
index a562013b8..4a8ef29fd 100644
--- a/docs/xml/Android.Views.Inspectors/InspectionCompanionUninitializedPropertyMapException.xml
+++ b/docs/xml/Android.Views.Inspectors/InspectionCompanionUninitializedPropertyMapException.xml
@@ -65,8 +65,8 @@
       </Attributes>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Initializes an exception for attempts to read inspectable properties before their IDs are mapped.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
diff --git a/docs/xml/Android.Views.Inspectors/IntFlagMapping.xml b/docs/xml/Android.Views.Inspectors/IntFlagMapping.xml
index 5127f462c..c8362c583 100644
--- a/docs/xml/Android.Views.Inspectors/IntFlagMapping.xml
+++ b/docs/xml/Android.Views.Inspectors/IntFlagMapping.xml
@@ -71,8 +71,8 @@
       </Attributes>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Initializes an empty mapping of flag values.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Add">
diff --git a/docs/xml/Android.Views.Inspectors/PropertyMapperPropertyConflictException.xml b/docs/xml/Android.Views.Inspectors/PropertyMapperPropertyConflictException.xml
index ec84deba2..1f9d65c84 100644
--- a/docs/xml/Android.Views.Inspectors/PropertyMapperPropertyConflictException.xml
+++ b/docs/xml/Android.Views.Inspectors/PropertyMapperPropertyConflictException.xml
@@ -89,11 +89,11 @@
         <Parameter Name="existingPropertyType" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <param name="newPropertyType">To be added.</param>
-        <param name="existingPropertyType">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="name">The name of the property being mapped.</param>
+        <param name="newPropertyType">The type requested for the property.</param>
+        <param name="existingPropertyType">The type previously mapped for the property.</param>
+        <summary>Initializes an exception for a property name mapped to incompatible types.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="JniPeerMembers">
diff --git a/docs/xml/Android.Views.Inspectors/PropertyReaderPropertyTypeMismatchException.xml b/docs/xml/Android.Views.Inspectors/PropertyReaderPropertyTypeMismatchException.xml
index 408752fbf..fe9d78f44 100644
--- a/docs/xml/Android.Views.Inspectors/PropertyReaderPropertyTypeMismatchException.xml
+++ b/docs/xml/Android.Views.Inspectors/PropertyReaderPropertyTypeMismatchException.xml
@@ -89,11 +89,11 @@
         <Parameter Name="actualPropertyType" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="id">To be added.</param>
-        <param name="expectedPropertyType">To be added.</param>
-        <param name="actualPropertyType">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="id">The identifier of the property that was read.</param>
+        <param name="expectedPropertyType">The type used to read the property.</param>
+        <param name="actualPropertyType">The type mapped for the property identifier.</param>
+        <summary>Initializes an exception for a property identifier read using a type different from its mapped type.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -130,12 +130,12 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="id">To be added.</param>
-        <param name="expectedPropertyType">To be added.</param>
-        <param name="actualPropertyType">To be added.</param>
-        <param name="propertyName">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="id">The identifier of the property that was read.</param>
+        <param name="expectedPropertyType">The type used to read the property.</param>
+        <param name="actualPropertyType">The type mapped for the property identifier.</param>
+        <param name="propertyName">The name of the property, if available.</param>
+        <summary>Initializes an exception for a property read using a type different from its mapped type.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="JniPeerMembers">
diff --git a/docs/xml/Android.Views.Inspectors/StaticInspectionCompanionProvider.xml b/docs/xml/Android.Views.Inspectors/StaticInspectionCompanionProvider.xml
index 01a7903ec..8e7269b84 100644
--- a/docs/xml/Android.Views.Inspectors/StaticInspectionCompanionProvider.xml
+++ b/docs/xml/Android.Views.Inspectors/StaticInspectionCompanionProvider.xml
@@ -76,8 +76,8 @@
       </Attributes>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Initializes a provider that locates companions by the inspectable type's generated companion class name.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -173,10 +173,10 @@
         <Parameter Name="cls" Type="Java.Lang.Class" />
       </Parameters>
       <Docs>
-        <param name="cls">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="cls">The inspectable type whose companion is requested.</param>
+        <summary>Locates and instantiates the inspection companion class associated with an inspectable type.</summary>
+        <returns>The inspection companion, or <see langword="null" /> when no compatible companion class is found.</returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ThresholdClass">
diff --git a/docs/xml/Android.Views.Inspectors/WindowInspector.xml b/docs/xml/Android.Views.Inspectors/WindowInspector.xml
index 0ec22f31e..9ea7756e5 100644
--- a/docs/xml/Android.Views.Inspectors/WindowInspector.xml
+++ b/docs/xml/Android.Views.Inspectors/WindowInspector.xml
@@ -66,7 +66,7 @@
         <ReturnType>System.Collections.Generic.IList&lt;Android.Views.View&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the window views attached to the current process.</summary>
         <value>the list of all window views attached to the current process</value>
         <remarks>
           <para>