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.S7.Tests/S7DiscoveryAndSubscribeTests.cs

@@ -18,27 +18,53 @@ public sealed class S7DiscoveryAndSubscribeTests
         public readonly List<string> Folders = new();
         public readonly List<(string Name, DriverAttributeInfo Attr)> Variables = new();
 
+        /// <summary>Adds a folder to the address space.</summary>
+        /// <param name="browseName">The browse name of the folder.</param>
+        /// <param name="displayName">The display name of the folder.</param>
+        /// <returns>This builder instance for method chaining.</returns>
         public IAddressSpaceBuilder Folder(string browseName, string displayName)
         {
             Folders.Add(browseName);
             return this;
         }
+
+        /// <summary>Adds a variable to the address space.</summary>
+        /// <param name="browseName">The browse name of the variable.</param>
+        /// <param name="displayName">The display name of the variable.</param>
+        /// <param name="attributeInfo">The attribute information for the variable.</param>
+        /// <returns>A handle to the created variable.</returns>
         public IVariableHandle Variable(string browseName, string displayName, DriverAttributeInfo attributeInfo)
         {
             Variables.Add((browseName, attributeInfo));
             return new StubHandle();
         }
+
+        /// <summary>Adds a property to a variable.</summary>
+        /// <param name="browseName">The browse name of the property.</param>
+        /// <param name="dataType">The data type of the property.</param>
+        /// <param name="value">The initial value of the property.</param>
         public void AddProperty(string browseName, DriverDataType dataType, object? value) { }
+
+        /// <summary>Attaches an alarm condition to a variable.</summary>
+        /// <param name="sourceVariable">The variable to attach the alarm to.</param>
+        /// <param name="alarmName">The name of the alarm.</param>
+        /// <param name="alarmInfo">The alarm information.</param>
         public void AttachAlarmCondition(IVariableHandle sourceVariable, string alarmName, DriverAttributeInfo alarmInfo) { }
 
         private sealed class StubHandle : IVariableHandle
         {
+            /// <summary>Gets the full reference of the variable.</summary>
             public string FullReference => "stub";
+
+            /// <summary>Marks this variable as an alarm condition.</summary>
+            /// <param name="info">The alarm condition information.</param>
+            /// <returns>An alarm condition sink.</returns>
             public IAlarmConditionSink MarkAsAlarmCondition(AlarmConditionInfo info)
                 => throw new NotImplementedException("S7 driver never calls this — no alarm surfacing");
         }
     }
 
+    /// <summary>Verifies that DiscoverAsync projects every configured tag into the address space.</summary>
     [Fact]
     public async Task DiscoverAsync_projects_every_tag_into_the_address_space()
     {
@@ -65,6 +91,7 @@ public sealed class S7DiscoveryAndSubscribeTests
         builder.Variables[2].Attr.DriverDataType.ShouldBe(DriverDataType.Float32);
     }
 
+    /// <summary>Verifies that DiscoverAsync propagates the WriteIdempotent flag from tag configuration to attribute info.</summary>
     [Fact]
     public async Task DiscoverAsync_propagates_WriteIdempotent_from_tag_to_attribute_info()
     {
@@ -86,6 +113,7 @@ public sealed class S7DiscoveryAndSubscribeTests
         builder.Variables.Single(v => v.Name == "StartBit").Attr.WriteIdempotent.ShouldBeFalse("default is opt-in per decision #44");
     }
 
+    /// <summary>Verifies that GetHostStatuses returns one row with the host:port identity in pre-init state.</summary>
     [Fact]
     public void GetHostStatuses_returns_one_row_with_host_port_identity_pre_init()
     {
@@ -98,6 +126,7 @@ public sealed class S7DiscoveryAndSubscribeTests
         rows[0].State.ShouldBe(HostState.Unknown, "pre-init / pre-probe state is Unknown");
     }
 
+    /// <summary>Verifies that SubscribeAsync returns unique handles and UnsubscribeAsync correctly accepts them.</summary>
     [Fact]
     public async Task SubscribeAsync_returns_unique_handles_and_UnsubscribeAsync_accepts_them()
     {
@@ -121,6 +150,7 @@ public sealed class S7DiscoveryAndSubscribeTests
         await drv.UnsubscribeAsync(h1, TestContext.Current.CancellationToken);
     }
 
+    /// <summary>Verifies that Subscribe floors the publishing interval at 100ms.</summary>
     [Fact]
     public async Task Subscribe_publishing_interval_is_floored_at_100ms()
     {