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.AbLegacy.Tests/AbLegacyCapabilityTests.cs

@@ -11,6 +11,7 @@ public sealed class AbLegacyCapabilityTests
 {
     // ---- ITagDiscovery ----
 
+    /// <summary>Verifies that DiscoverAsync emits pre-declared tags under the device folder.</summary>
     [Fact]
     public async Task DiscoverAsync_emits_pre_declared_tags_under_device_folder()
     {
@@ -38,6 +39,7 @@ public sealed class AbLegacyCapabilityTests
 
     // ---- ISubscribable ----
 
+    /// <summary>Verifies that Subscribe initial poll raises OnDataChange.</summary>
     [Fact]
     public async Task Subscribe_initial_poll_raises_OnDataChange()
     {
@@ -63,6 +65,7 @@ public sealed class AbLegacyCapabilityTests
         await drv.UnsubscribeAsync(handle, CancellationToken.None);
     }
 
+    /// <summary>Verifies that Unsubscribe halts polling.</summary>
     [Fact]
     public async Task Unsubscribe_halts_polling()
     {
@@ -92,6 +95,7 @@ public sealed class AbLegacyCapabilityTests
 
     // ---- IHostConnectivityProbe ----
 
+    /// <summary>Verifies that GetHostStatuses returns one status per device.</summary>
     [Fact]
     public async Task GetHostStatuses_returns_one_per_device()
     {
@@ -109,6 +113,7 @@ public sealed class AbLegacyCapabilityTests
         drv.GetHostStatuses().Count.ShouldBe(2);
     }
 
+    /// <summary>Verifies that Probe transitions to Running on successful read.</summary>
     [Fact]
     public async Task Probe_transitions_to_Running_on_successful_read()
     {
@@ -132,6 +137,7 @@ public sealed class AbLegacyCapabilityTests
         await drv.ShutdownAsync(CancellationToken.None);
     }
 
+    /// <summary>Verifies that Probe transitions to Stopped on read failure.</summary>
     [Fact]
     public async Task Probe_transitions_to_Stopped_on_read_failure()
     {
@@ -155,6 +161,7 @@ public sealed class AbLegacyCapabilityTests
         await drv.ShutdownAsync(CancellationToken.None);
     }
 
+    /// <summary>Verifies that Probe is disabled when ProbeAddress is null.</summary>
     [Fact]
     public async Task Probe_disabled_when_ProbeAddress_is_null()
     {
@@ -172,6 +179,7 @@ public sealed class AbLegacyCapabilityTests
 
     // ---- IPerCallHostResolver ----
 
+    /// <summary>Verifies that ResolveHost returns declared device for known tag.</summary>
     [Fact]
     public async Task ResolveHost_returns_declared_device_for_known_tag()
     {
@@ -195,6 +203,7 @@ public sealed class AbLegacyCapabilityTests
         drv.ResolveHost("B").ShouldBe("ab://10.0.0.6/1,0");
     }
 
+    /// <summary>Verifies that ResolveHost falls back to first device for unknown tags.</summary>
     [Fact]
     public async Task ResolveHost_falls_back_to_first_device_for_unknown()
     {
@@ -208,6 +217,7 @@ public sealed class AbLegacyCapabilityTests
         drv.ResolveHost("missing").ShouldBe("ab://10.0.0.5/1,0");
     }
 
+    /// <summary>Verifies that ResolveHost falls back to DriverInstanceId when no devices exist.</summary>
     [Fact]
     public async Task ResolveHost_falls_back_to_DriverInstanceId_when_no_devices()
     {
@@ -228,22 +238,43 @@ public sealed class AbLegacyCapabilityTests
 
     private sealed class RecordingBuilder : IAddressSpaceBuilder
     {
+        /// <summary>Gets list of folders created during discovery.</summary>
         public List<(string BrowseName, string DisplayName)> Folders { get; } = new();
+        /// <summary>Gets list of variables created during discovery.</summary>
         public List<(string BrowseName, DriverAttributeInfo Info)> Variables { get; } = new();
 
+        /// <summary>Records folder creation.</summary>
+        /// <param name="browseName">The browse name of the folder.</param>
+        /// <param name="displayName">The display name of the folder.</param>
         public IAddressSpaceBuilder Folder(string browseName, string displayName)
         { Folders.Add((browseName, displayName)); return this; }
 
+        /// <summary>Records variable creation.</summary>
+        /// <param name="browseName">The browse name of the variable.</param>
+        /// <param name="displayName">The display name of the variable.</param>
+        /// <param name="info">The driver attribute information.</param>
         public IVariableHandle Variable(string browseName, string displayName, DriverAttributeInfo info)
         { Variables.Add((browseName, info)); return new Handle(info.FullName); }
 
+        /// <summary>Records property addition (stub implementation).</summary>
+        /// <param name="_">The property name (unused).</param>
+        /// <param name="__">The data type (unused).</param>
+        /// <param name="___">The property value (unused).</param>
         public void AddProperty(string _, DriverDataType __, object? ___) { }
 
         private sealed class Handle(string fullRef) : IVariableHandle
         {
+            /// <summary>Gets the full reference of the variable.</summary>
             public string FullReference => fullRef;
+            /// <summary>Marks the variable as an alarm condition.</summary>
+            /// <param name="info">The alarm condition information.</param>
             public IAlarmConditionSink MarkAsAlarmCondition(AlarmConditionInfo info) => new NullSink();
         }
-        private sealed class NullSink : IAlarmConditionSink { public void OnTransition(AlarmEventArgs args) { } }
+        /// <summary>Null sink for alarm condition transitions.</summary>
+        private sealed class NullSink : IAlarmConditionSink
+        {
+            /// <inheritdoc />
+            public void OnTransition(AlarmEventArgs args) { }
+        }
     }
 }