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.AbCip.Tests/AbCipPlcFamilyTests.cs

@@ -11,6 +11,7 @@ public sealed class AbCipPlcFamilyTests
 {
     // ---- ControlLogix ----
 
+    /// <summary>Verifies that the ControlLogix profile defaults match the large forward open baseline.</summary>
     [Fact]
     public void ControlLogix_profile_defaults_match_large_forward_open_baseline()
     {
@@ -23,6 +24,7 @@ public sealed class AbCipPlcFamilyTests
         p.MaxFragmentBytes.ShouldBe(4000);
     }
 
+    /// <summary>Verifies that a ControlLogix device initializes with the correct profile.</summary>
     [Fact]
     public async Task ControlLogix_device_initialises_with_correct_profile()
     {
@@ -38,6 +40,7 @@ public sealed class AbCipPlcFamilyTests
 
     // ---- CompactLogix ----
 
+    /// <summary>Verifies that the CompactLogix profile uses a narrower connection size than ControlLogix.</summary>
     [Fact]
     public void CompactLogix_profile_uses_narrower_connection_size()
     {
@@ -50,6 +53,7 @@ public sealed class AbCipPlcFamilyTests
         p.MaxFragmentBytes.ShouldBe(500);
     }
 
+    /// <summary>Verifies that a CompactLogix device initializes with a narrow connection size.</summary>
     [Fact]
     public async Task CompactLogix_device_initialises_with_narrow_ConnectionSize()
     {
@@ -67,6 +71,7 @@ public sealed class AbCipPlcFamilyTests
 
     // ---- Micro800 ----
 
+    /// <summary>Verifies that the Micro800 profile is unconnected only and supports an empty CIP path.</summary>
     [Fact]
     public void Micro800_profile_is_unconnected_only_with_empty_path()
     {
@@ -79,6 +84,7 @@ public sealed class AbCipPlcFamilyTests
         p.MaxFragmentBytes.ShouldBe(484);
     }
 
+    /// <summary>Verifies that a Micro800 device with an empty CIP path parses correctly.</summary>
     [Fact]
     public async Task Micro800_device_with_empty_cip_path_parses_correctly()
     {
@@ -95,6 +101,7 @@ public sealed class AbCipPlcFamilyTests
         state.Profile.SupportsConnectedMessaging.ShouldBeFalse();
     }
 
+    /// <summary>Verifies that Micro800 read operations forward the empty path to tag creation parameters.</summary>
     [Fact]
     public async Task Micro800_read_forwards_empty_path_to_tag_create_params()
     {
@@ -114,6 +121,7 @@ public sealed class AbCipPlcFamilyTests
 
     // ---- GuardLogix ----
 
+    /// <summary>Verifies that the GuardLogix profile wire protocol mirrors ControlLogix.</summary>
     [Fact]
     public void GuardLogix_profile_wire_protocol_mirrors_ControlLogix()
     {
@@ -125,6 +133,7 @@ public sealed class AbCipPlcFamilyTests
         p.DefaultCipPath.ShouldBe(AbCipPlcFamilyProfile.ControlLogix.DefaultCipPath);
     }
 
+    /// <summary>Verifies that GuardLogix safety tags surface as ViewOnly in discovery.</summary>
     [Fact]
     public async Task GuardLogix_safety_tag_surfaces_as_ViewOnly_in_discovery()
     {
@@ -150,6 +159,7 @@ public sealed class AbCipPlcFamilyTests
             .ShouldBe(SecurityClassification.ViewOnly);
     }
 
+    /// <summary>Verifies that GuardLogix safety tag writes are rejected even when the tag is marked Writable.</summary>
     [Fact]
     public async Task GuardLogix_safety_tag_writes_rejected_even_when_Writable_is_true()
     {
@@ -174,6 +184,9 @@ public sealed class AbCipPlcFamilyTests
 
     // ---- ForFamily dispatch ----
 
+    /// <summary>Verifies that ForFamily dispatches to the correct profile for each PLC family.</summary>
+    /// <param name="family">The AB CIP PLC family to test.</param>
+    /// <param name="expectedAttribute">The expected libplctag PLC attribute string.</param>
     [Theory]
     [InlineData(AbCipPlcFamily.ControlLogix, "controllogix")]
     [InlineData(AbCipPlcFamily.CompactLogix, "compactlogix")]
@@ -188,22 +201,43 @@ public sealed class AbCipPlcFamilyTests
 
     private sealed class RecordingBuilder : IAddressSpaceBuilder
     {
+        /// <summary>Gets the list of folders recorded by this builder.</summary>
         public List<(string BrowseName, string DisplayName)> Folders { get; } = new();
+        /// <summary>Gets the list of variables recorded by this builder.</summary>
         public List<(string BrowseName, DriverAttributeInfo Info)> Variables { get; } = new();
 
+        /// <summary>Adds a folder to the recorded list and returns this builder for chaining.</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>Adds a variable to the recorded list and returns a handle.</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>No-op property adding operation for test compatibility.</summary>
+        /// <param name="_">The property name.</param>
+        /// <param name="__">The property data type.</param>
+        /// <param name="___">The property value.</param>
         public void AddProperty(string _, DriverDataType __, object? ___) { }
 
         private sealed class Handle(string fullRef) : IVariableHandle
         {
+            /// <summary>Gets the full reference for this variable handle.</summary>
             public string FullReference => fullRef;
+            /// <summary>Marks this variable as an alarm condition and returns a null sink.</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) { } }
+        private sealed class NullSink : IAlarmConditionSink
+        {
+            /// <summary>Called when an alarm state transitions.</summary>
+            /// <param name="args">The alarm event arguments.</param>
+            public void OnTransition(AlarmEventArgs args) { }
+        }
     }
 }