docs: backfill XML documentation across 756 files

Adds <summary>, <param>, <typeparam>, and <inheritdoc/> tags to public
members surfaced by commentchecker — resolves 5,847 of 5,869 issues
(99.6%) across three /fixdocs passes.

tests/Drivers/ZB.MOM.WW.OtOpcUa.Driver.Modbus.Tests/ModbusLifecycleHygieneTests.cs

@@ -23,8 +23,14 @@ public sealed class ModbusLifecycleHygieneTests
         public int DisposeCount;
         public int SendCount;
 
+        /// <summary>Establishes a connection asynchronously.</summary>
+        /// <param name="ct">Cancellation token for the operation.</param>
         public Task ConnectAsync(CancellationToken ct) { Interlocked.Increment(ref ConnectCount); return Task.CompletedTask; }
 
+        /// <summary>Sends a Modbus PDU and receives the response.</summary>
+        /// <param name="unitId">The Modbus unit identifier.</param>
+        /// <param name="pdu">The Protocol Data Unit to send.</param>
+        /// <param name="ct">Cancellation token for the operation.</param>
         public Task<byte[]> SendAsync(byte unitId, byte[] pdu, CancellationToken ct)
         {
             Interlocked.Increment(ref SendCount);
@@ -65,6 +71,7 @@ public sealed class ModbusLifecycleHygieneTests
             }
         }
 
+        /// <summary>Disposes the transport asynchronously.</summary>
         public ValueTask DisposeAsync() { Interlocked.Increment(ref DisposeCount); return ValueTask.CompletedTask; }
     }
 
@@ -79,6 +86,7 @@ public sealed class ModbusLifecycleHygieneTests
 
     // -------------------- Finding -002 / -012 (2) --------------------
 
+    /// <summary>Verifies that reinitialization clears stale tag cache entries.</summary>
     [Fact]
     public async Task Reinitialize_clears_stale_tagsByName_entries()
     {
@@ -99,6 +107,7 @@ public sealed class ModbusLifecycleHygieneTests
         GetTagsByName(drv).Count.ShouldBe(0, "Shutdown must clear the tag cache so the next Initialize starts clean");
     }
 
+    /// <summary>Verifies that reinitialization clears the deadband and write-suppression caches.</summary>
     [Fact]
     public async Task Reinitialize_clears_lastPublished_and_lastWritten_caches()
     {
@@ -139,6 +148,7 @@ public sealed class ModbusLifecycleHygieneTests
 
     // -------------------- Finding -004 / -012 (4) --------------------
 
+    /// <summary>Verifies that DisposeAsync without Shutdown stops probe loops and tears down the transport.</summary>
     [Fact]
     public async Task DisposeAsync_without_explicit_Shutdown_tears_down_probe_loop_and_transport()
     {
@@ -176,6 +186,7 @@ public sealed class ModbusLifecycleHygieneTests
         (sendsAtRest - sendsAfterDispose).ShouldBeLessThanOrEqualTo(1, "background loops must stop after DisposeAsync");
     }
 
+    /// <summary>Verifies that DisposeAsync disposes the poll engine so subscriptions stop.</summary>
     [Fact]
     public async Task DisposeAsync_disposes_the_pollEngine_so_subscriptions_stop()
     {
@@ -221,7 +232,13 @@ public sealed class ModbusLifecycleHygieneTests
         /// <summary>How many bytes to return — anything &lt; 2 + bytecount is malformed.</summary>
         public int ResponseBytes { get; set; } = 1; // just the fc byte, no bytecount
 
+        /// <summary>Establishes a connection asynchronously.</summary>
+        /// <param name="ct">Cancellation token for the operation.</param>
         public Task ConnectAsync(CancellationToken ct) => Task.CompletedTask;
+        /// <summary>Sends a Modbus PDU and receives the response.</summary>
+        /// <param name="unitId">The Modbus unit identifier.</param>
+        /// <param name="pdu">The Protocol Data Unit to send.</param>
+        /// <param name="ct">Cancellation token for the operation.</param>
         public Task<byte[]> SendAsync(byte unitId, byte[] pdu, CancellationToken ct)
         {
             var resp = new byte[ResponseBytes];
@@ -229,9 +246,11 @@ public sealed class ModbusLifecycleHygieneTests
             if (ResponseBytes >= 2) resp[1] = 4; // claim 4 bytes of payload but provide none
             return Task.FromResult(resp);
         }
+        /// <summary>Disposes the transport asynchronously.</summary>
         public ValueTask DisposeAsync() => ValueTask.CompletedTask;
     }
 
+    /// <summary>Verifies that short response PDUs surface as BadCommunicationError, not IndexOutOfRangeException.</summary>
     [Fact]
     public async Task Short_response_PDU_surfaces_as_BadCommunicationError_not_an_IndexOutOfRangeException()
     {
@@ -249,6 +268,7 @@ public sealed class ModbusLifecycleHygieneTests
         r[0].Value.ShouldBeNull();
     }
 
+    /// <summary>Verifies that response payloads truncated below declared byte count surface as BadCommunicationError.</summary>
     [Fact]
     public async Task Response_payload_truncated_below_declared_byteCount_surfaces_as_BadCommunicationError()
     {
@@ -267,6 +287,7 @@ public sealed class ModbusLifecycleHygieneTests
         r[0].StatusCode.ShouldBe(0x80050000u);
     }
 
+    /// <summary>Verifies that DecodeBitArray rejects an empty bitmap with InvalidDataException.</summary>
     [Fact]
     public void DecodeBitArray_rejects_an_empty_bitmap_with_InvalidDataException()
     {
@@ -296,9 +317,16 @@ public sealed class ModbusLifecycleHygieneTests
     /// </summary>
     private sealed class EmptyBitTransport : IModbusTransport
     {
+        /// <summary>Returns a completed task without performing any connection.</summary>
+        /// <param name="ct">The cancellation token for the operation.</param>
         public Task ConnectAsync(CancellationToken ct) => Task.CompletedTask;
+        /// <summary>Returns a response with zero-byte payload to simulate empty bitmap.</summary>
+        /// <param name="unitId">The Modbus unit ID.</param>
+        /// <param name="pdu">The protocol data unit being sent.</param>
+        /// <param name="ct">The cancellation token for the operation.</param>
         public Task<byte[]> SendAsync(byte unitId, byte[] pdu, CancellationToken ct)
             => Task.FromResult(new byte[] { pdu[0], 0 });
+        /// <summary>Completes the disposal without doing any work.</summary>
         public ValueTask DisposeAsync() => ValueTask.CompletedTask;
     }