From e87062158277c43badf13fb59a57e7ddb73715da Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 11:42:08 -0500
Subject: [PATCH] Document CheckBoxPreference overrides

Refs #145

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../CheckBoxPreference.xml                    | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/docs/xml/Android.Preferences/CheckBoxPreference.xml b/docs/xml/Android.Preferences/CheckBoxPreference.xml
index fabf4e69d..2c1d2d2c6 100644
--- a/docs/xml/Android.Preferences/CheckBoxPreference.xml
+++ b/docs/xml/Android.Preferences/CheckBoxPreference.xml
@@ -244,8 +244,8 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Returns the checked state. -or- Sets the checked state and saves it to the <c>SharedPreferences</c>.</summary>
+        <value>The checked state.</value>
         <remarks>
           <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>
@@ -279,8 +279,11 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Returns whether dependents are disabled when this preference is on (<c>true</c>)
+            or when this preference is off (<c>false</c>). -or- Sets whether dependents are disabled when this preference is on (<c>true</c>)
+            or when this preference is off (<c>false</c>).</summary>
+        <value>Whether dependents are disabled when this preference is on (<c>true</c>)
+            or when this preference is off (<c>false</c>).</value>
         <remarks>
           <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>
@@ -438,8 +441,8 @@
         <ReturnType>Java.Lang.ICharSequence</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Returns the summary to be shown when unchecked. -or- Sets the summary to be shown when unchecked.</summary>
+        <value>The summary.</value>
         <remarks>
           <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>
@@ -494,8 +497,8 @@
         <ReturnType>Java.Lang.ICharSequence</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Returns the summary to be shown when checked. -or- Sets the summary to be shown when checked.</summary>
+        <value>The summary.</value>
         <remarks>
           <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>