Expand XML docs across bridge and test code

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

@@ -4,8 +4,16 @@ using ZB.MOM.WW.LmxOpcUa.Host.Domain;
 
 namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
 {
+    /// <summary>
+    /// Verifies the mapping between MXAccess quality codes, bridge quality values, and OPC UA status codes.
+    /// </summary>
     public class QualityMapperTests
     {
+        /// <summary>
+        /// Confirms that bad-family MXAccess quality values map to the expected bridge quality values.
+        /// </summary>
+        /// <param name="input">The raw MXAccess quality code.</param>
+        /// <param name="expected">The bridge quality value expected for the code.</param>
         [Theory]
         [InlineData(0, Quality.Bad)]
         [InlineData(4, Quality.BadConfigError)]
@@ -16,6 +24,11 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
             QualityMapper.MapFromMxAccessQuality(input).ShouldBe(expected);
         }
 
+        /// <summary>
+        /// Confirms that uncertain-family MXAccess quality values map to the expected bridge quality values.
+        /// </summary>
+        /// <param name="input">The raw MXAccess quality code.</param>
+        /// <param name="expected">The bridge quality value expected for the code.</param>
         [Theory]
         [InlineData(64, Quality.Uncertain)]
         [InlineData(68, Quality.UncertainLastUsable)]
@@ -25,6 +38,11 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
             QualityMapper.MapFromMxAccessQuality(input).ShouldBe(expected);
         }
 
+        /// <summary>
+        /// Confirms that good-family MXAccess quality values map to the expected bridge quality values.
+        /// </summary>
+        /// <param name="input">The raw MXAccess quality code.</param>
+        /// <param name="expected">The bridge quality value expected for the code.</param>
         [Theory]
         [InlineData(192, Quality.Good)]
         [InlineData(216, Quality.GoodLocalOverride)]
@@ -33,48 +51,72 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
             QualityMapper.MapFromMxAccessQuality(input).ShouldBe(expected);
         }
 
+        /// <summary>
+        /// Confirms that unknown bad-family values collapse to the generic bad quality bucket.
+        /// </summary>
         [Fact]
         public void MapFromMxAccess_UnknownBadValue_ReturnsBad()
         {
             QualityMapper.MapFromMxAccessQuality(63).ShouldBe(Quality.Bad);
         }
 
+        /// <summary>
+        /// Confirms that unknown uncertain-family values collapse to the generic uncertain quality bucket.
+        /// </summary>
         [Fact]
         public void MapFromMxAccess_UnknownUncertainValue_ReturnsUncertain()
         {
             QualityMapper.MapFromMxAccessQuality(100).ShouldBe(Quality.Uncertain);
         }
 
+        /// <summary>
+        /// Confirms that unknown good-family values collapse to the generic good quality bucket.
+        /// </summary>
         [Fact]
         public void MapFromMxAccess_UnknownGoodValue_ReturnsGood()
         {
             QualityMapper.MapFromMxAccessQuality(200).ShouldBe(Quality.Good);
         }
 
+        /// <summary>
+        /// Confirms that the generic good quality maps to the OPC UA good status code.
+        /// </summary>
         [Fact]
         public void MapToOpcUa_Good_Returns0()
         {
             QualityMapper.MapToOpcUaStatusCode(Quality.Good).ShouldBe(0x00000000u);
         }
 
+        /// <summary>
+        /// Confirms that the generic bad quality maps to the OPC UA bad status code.
+        /// </summary>
         [Fact]
         public void MapToOpcUa_Bad_Returns80000000()
         {
             QualityMapper.MapToOpcUaStatusCode(Quality.Bad).ShouldBe(0x80000000u);
         }
 
+        /// <summary>
+        /// Confirms that communication failures map to the OPC UA bad communication-failure status code.
+        /// </summary>
         [Fact]
         public void MapToOpcUa_BadCommFailure()
         {
             QualityMapper.MapToOpcUaStatusCode(Quality.BadCommFailure).ShouldBe(0x80050000u);
         }
 
+        /// <summary>
+        /// Confirms that the generic uncertain quality maps to the OPC UA uncertain status code.
+        /// </summary>
         [Fact]
         public void MapToOpcUa_Uncertain()
         {
             QualityMapper.MapToOpcUaStatusCode(Quality.Uncertain).ShouldBe(0x40000000u);
         }
 
+        /// <summary>
+        /// Confirms that good quality values are classified correctly by the quality extension helpers.
+        /// </summary>
         [Fact]
         public void QualityExtensions_IsGood()
         {
@@ -83,6 +125,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
             Quality.Good.IsUncertain().ShouldBe(false);
         }
 
+        /// <summary>
+        /// Confirms that bad quality values are classified correctly by the quality extension helpers.
+        /// </summary>
         [Fact]
         public void QualityExtensions_IsBad()
         {
@@ -90,6 +135,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Domain
             Quality.Bad.IsGood().ShouldBe(false);
         }
 
+        /// <summary>
+        /// Confirms that uncertain quality values are classified correctly by the quality extension helpers.
+        /// </summary>
         [Fact]
         public void QualityExtensions_IsUncertain()
         {