Polish XML comments

src/Ramstack.HtmxToolkit/HtmxAssets.cs

@@ -4,22 +4,22 @@
 namespace Ramstack.HtmxToolkit;
 
 /// <summary>
-/// Provides access to embedded javascript assets.
+/// Provides access to the embedded HTMX toolkit script assets.
 /// </summary>
 public static class HtmxAssets
 {
     /// <summary>
-    /// The debug version of the script to integrate with the anti-forgery feature of ASP.NET Core.
+    /// The unminified HTMX toolkit script.
     /// </summary>
     public static readonly string DebugScript = GetResource("htmx-toolkit.js");
 
     /// <summary>
-    /// The minified version of the script to integrate with the anti-forgery feature of ASP.NET Core.
+    /// The minified HTMX toolkit script.
     /// </summary>
     public static readonly string Script = GetResource("htmx-toolkit.min.js");
 
     /// <summary>
-    /// The hash of the current script.
+    /// The content hash of the HTMX toolkit script.
     /// </summary>
     public static readonly string Hash = Convert
         .ToHexString(SHA1.HashData(Encoding.UTF8.GetBytes(DebugScript)).AsSpan(0, 8))

src/Ramstack.HtmxToolkit/HtmxRequestHeaders.cs

@@ -46,7 +46,7 @@ internal HtmxRequestHeaders(HttpRequest request) =>
     public string? Prompt => GetString(_headers, HtmxRequestHeaderNames.Prompt);
 
     /// <summary>
-    /// Gets a value indicating whether the current request is htmx request.
+    /// Gets a value indicating whether the current request is an HTMX request.
     /// </summary>
     /// <remarks><see cref="HtmxRequestHeaderNames.Request"/></remarks>
     public bool Request => GetBoolean(_headers, HtmxRequestHeaderNames.Request);

src/Ramstack.HtmxToolkit/HtmxResponse.cs

@@ -9,7 +9,7 @@
 namespace Ramstack.HtmxToolkit;
 
 /// <summary>
-/// Represents HTTP response to set htmx response headers.
+/// Represents an HTTP response whose HTMX response headers can be configured.
 /// </summary>
 /// <remarks>
 /// Like <see cref="HttpContext"/> and <see cref="HttpResponse"/> themselves, this type is not thread-safe.

src/Ramstack.HtmxToolkit/HtmxResponseHeaders.cs

@@ -61,7 +61,7 @@ public bool Refresh
     }
 
     /// <summary>
-    /// Gets or Sets the <c>HX-Replace-Url</c> header to replace the current URL
+    /// Gets or sets the <c>HX-Replace-Url</c> header to replace the current URL
     /// without pushing a new entry to the browser's history stack.
     /// </summary>
     [MaybeNull]

src/Ramstack.HtmxToolkit/HtmxTriggerTiming.cs

@@ -13,7 +13,7 @@ public enum HtmxTriggerTiming
 
     /// <summary>
     /// Maps to the <c>HX-Trigger-After-Swap</c> header that is used to trigger an event
-    /// on the client side after the htmx request has been swapped.
+    /// on the client side after the response content has been swapped into the DOM.
     /// </summary>
     AfterSwap,
 

src/Ramstack.HtmxToolkit/Internal/HttpVerbArray.cs

@@ -4,9 +4,7 @@
 namespace Ramstack.HtmxToolkit.Internal;
 
 /// <summary>
-/// A lightweight wrapper over an array of <see cref="HttpVerb"/> values
-/// that implements <see cref="IEnumerable{T}"/> to lazily produce lowercase
-/// HTTP method strings without allocating an intermediate <see cref="string"/> array.
+/// Represents a lightweight wrapper over an array of <see cref="HttpVerb"/> values.
 /// </summary>
 internal readonly struct HttpVerbArray : IEnumerable<string>
 {

src/Ramstack.HtmxToolkit/TagHelpers/HtmxHeaderTagHelper.cs

@@ -22,7 +22,7 @@ public sealed class HtmxHeaderTagHelper : TagHelper
     private const string HeadersDictionaryName = "hx-all-headers";
 
     /// <summary>
-    /// Gets or sets the <c>hx-header</c> attribute values.
+    /// Gets or sets the <c>hx-headers</c> attribute values.
     /// </summary>
     [HtmlAttributeName(HeadersDictionaryName, DictionaryAttributePrefix = HeadersPrefix)]
     public IDictionary<string, string> Headers