From ea0d42903579b0e8cd8b4a44282840ecd7787c34 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 09:38:39 -0500
Subject: [PATCH 1/2] Document Apache cookie spec factory

Refs #266

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml b/docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml
index 3a18ae1eb..2068020ec 100644
--- a/docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml
+++ b/docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml
@@ -29,7 +29,7 @@
     </Attribute>
   </Attributes>
   <Docs since="1">
-    <summary>To be added.</summary>
+    <summary>Factory interface for <see cref="T:Org.Apache.Http.Cookies.ICookieSpec" /> implementations.</summary>
     <remarks>
       <para>
         <format type="text/html">
@@ -63,10 +63,9 @@
         <Parameter Name="params" Type="Org.Apache.Http.Params.IHttpParams" />
       </Parameters>
       <Docs>
-        <param name="params">To be added.</param>
-        <summary>
-        </summary>
-        <returns>To be added.</returns>
+        <param name="params">HTTP parameters.</param>
+        <summary>Creates a <see cref="T:Org.Apache.Http.Cookies.ICookieSpec" /> instance using the given HTTP parameters.</summary>
+        <returns>A cookie specification.</returns>
         <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>

From 586afaade1c59a2df97699d131f01228333655f6 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Sat, 15 Aug 2026 09:49:44 -0500
Subject: [PATCH 2/2] Clarify Apache cookie factory docs

Refs #266

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml b/docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml
index 2068020ec..56bc01fa2 100644
--- a/docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml
+++ b/docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml
@@ -63,9 +63,9 @@
         <Parameter Name="params" Type="Org.Apache.Http.Params.IHttpParams" />
       </Parameters>
       <Docs>
-        <param name="params">HTTP parameters.</param>
+        <param name="params">The HTTP parameters used to create the <see cref="T:Org.Apache.Http.Cookies.ICookieSpec" />.</param>
         <summary>Creates a <see cref="T:Org.Apache.Http.Cookies.ICookieSpec" /> instance using the given HTTP parameters.</summary>
-        <returns>A cookie specification.</returns>
+        <returns>The created <see cref="T:Org.Apache.Http.Cookies.ICookieSpec" />.</returns>
         <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>