Refine XML docs for historian, OPC UA, and tests

tests/ZB.MOM.WW.LmxOpcUa.Tests/Domain/SecurityClassificationMapperTests.cs

@@ -6,6 +6,11 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
 {
     public class SecurityClassificationMapperTests
     {
+        /// <summary>
+        /// Verifies that Galaxy classifications intended for operator and engineering writes remain writable through OPC UA.
+        /// </summary>
+        /// <param name="classification">The Galaxy security classification value being evaluated for write access.</param>
+        /// <param name="expected">The expected writable result for the supplied Galaxy classification.</param>
         [Theory]
         [InlineData(0, true)]  // FreeAccess
         [InlineData(1, true)]  // Operate
@@ -16,6 +21,11 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
             SecurityClassificationMapper.IsWritable(classification).ShouldBe(expected);
         }
 
+        /// <summary>
+        /// Verifies that secured or view-only Galaxy classifications are exposed as read-only attributes.
+        /// </summary>
+        /// <param name="classification">The Galaxy security classification value expected to block writes.</param>
+        /// <param name="expected">The expected writable result for the supplied read-only Galaxy classification.</param>
         [Theory]
         [InlineData(2, false)] // SecuredWrite
         [InlineData(3, false)] // VerifiedWrite
@@ -25,6 +35,10 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
             SecurityClassificationMapper.IsWritable(classification).ShouldBe(expected);
         }
 
+        /// <summary>
+        /// Verifies that unknown security classifications do not accidentally block writes for unmapped Galaxy values.
+        /// </summary>
+        /// <param name="classification">An unmapped Galaxy security classification value that should fall back to writable behavior.</param>
         [Theory]
         [InlineData(-1)]
         [InlineData(7)]