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/Cli/ZB.MOM.WW.OtOpcUa.Driver.AbCip.Cli.Tests/WriteCommandParseValueTests.cs

@@ -11,6 +11,9 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.AbCip.Cli.Tests;
 [Trait("Category", "Unit")]
 public sealed class WriteCommandParseValueTests
 {
+    /// <summary>Verifies ParseValue accepts common boolean aliases.</summary>
+    /// <param name="raw">Input string to parse.</param>
+    /// <param name="expected">Expected boolean value.</param>
     [Theory]
     [InlineData("true", true)]
     [InlineData("0", false)]
@@ -21,6 +24,7 @@ public sealed class WriteCommandParseValueTests
         WriteCommand.ParseValue(raw, AbCipDataType.Bool).ShouldBe(expected);
     }
 
+    /// <summary>Verifies ParseValue rejects invalid boolean input.</summary>
     [Fact]
     public void ParseValue_Bool_rejects_garbage()
     {
@@ -28,6 +32,7 @@ public sealed class WriteCommandParseValueTests
             () => WriteCommand.ParseValue("maybe", AbCipDataType.Bool));
     }
 
+    /// <summary>Verifies ParseValue correctly widens SInt to signed byte.</summary>
     [Fact]
     public void ParseValue_SInt_widens_to_sbyte()
     {
@@ -35,12 +40,14 @@ public sealed class WriteCommandParseValueTests
         WriteCommand.ParseValue("127", AbCipDataType.SInt).ShouldBe((sbyte)127);
     }
 
+    /// <summary>Verifies ParseValue correctly parses signed 16-bit integers.</summary>
     [Fact]
     public void ParseValue_Int_signed_16bit()
     {
         WriteCommand.ParseValue("-32768", AbCipDataType.Int).ShouldBe((short)-32768);
     }
 
+    /// <summary>Verifies ParseValue handles DInt and Dt data types as 32-bit integers.</summary>
     [Fact]
     public void ParseValue_DInt_and_Dt_both_land_on_int()
     {
@@ -48,12 +55,14 @@ public sealed class WriteCommandParseValueTests
         WriteCommand.ParseValue("1234567", AbCipDataType.Dt).ShouldBeOfType<int>();
     }
 
+    /// <summary>Verifies ParseValue correctly parses 64-bit long integers.</summary>
     [Fact]
     public void ParseValue_LInt_64bit()
     {
         WriteCommand.ParseValue("9223372036854775807", AbCipDataType.LInt).ShouldBe(long.MaxValue);
     }
 
+    /// <summary>Verifies ParseValue respects unsigned type bounds.</summary>
     [Fact]
     public void ParseValue_unsigned_range_respects_bounds()
     {
@@ -62,24 +71,28 @@ public sealed class WriteCommandParseValueTests
         WriteCommand.ParseValue("4294967295", AbCipDataType.UDInt).ShouldBeOfType<uint>();
     }
 
+    /// <summary>Verifies ParseValue correctly parses floating-point with invariant culture.</summary>
     [Fact]
     public void ParseValue_Real_invariant_culture_decimal()
     {
         WriteCommand.ParseValue("3.14", AbCipDataType.Real).ShouldBe(3.14f);
     }
 
+    /// <summary>Verifies ParseValue correctly handles double-precision floating-point.</summary>
     [Fact]
     public void ParseValue_LReal_handles_double_precision()
     {
         WriteCommand.ParseValue("2.718281828", AbCipDataType.LReal).ShouldBeOfType<double>();
     }
 
+    /// <summary>Verifies ParseValue passes through string values unchanged.</summary>
     [Fact]
     public void ParseValue_String_passthrough()
     {
         WriteCommand.ParseValue("hello logix", AbCipDataType.String).ShouldBe("hello logix");
     }
 
+    /// <summary>Verifies ParseValue throws for non-numeric input on numeric types.</summary>
     [Fact]
     public void ParseValue_non_numeric_for_numeric_types_throws_CommandException()
     {
@@ -87,6 +100,7 @@ public sealed class WriteCommandParseValueTests
             () => WriteCommand.ParseValue("xyz", AbCipDataType.DInt));
     }
 
+    /// <summary>Verifies ParseValue throws for out-of-range numeric values.</summary>
     [Fact]
     public void ParseValue_out_of_range_throws_CommandException()
     {
@@ -95,6 +109,9 @@ public sealed class WriteCommandParseValueTests
             () => WriteCommand.ParseValue("999", AbCipDataType.SInt));
     }
 
+    /// <summary>Verifies ParseValue exception messages include the input and data type for context.</summary>
+    /// <param name="raw">Input string to parse.</param>
+    /// <param name="type">Data type to parse into.</param>
     [Theory]
     [InlineData("12x", AbCipDataType.Int)]
     [InlineData("3.14", AbCipDataType.DInt)]
@@ -108,6 +125,10 @@ public sealed class WriteCommandParseValueTests
         ex.Message.ShouldContain(type.ToString());
     }
 
+    /// <summary>Verifies SynthesiseTagName preserves the tag path verbatim in the output.</summary>
+    /// <param name="path">Tag path.</param>
+    /// <param name="type">Data type.</param>
+    /// <param name="expected">Expected synthesized tag name.</param>
     [Theory]
     [InlineData("Motor01_Speed", AbCipDataType.Real, "Motor01_Speed:Real")]
     [InlineData("Program:Main.Counter", AbCipDataType.DInt, "Program:Main.Counter:DInt")]