Expand XML docs across bridge and test code

tests/ZB.MOM.WW.LmxOpcUa.Tests/MxAccess/StaComThreadTests.cs

@@ -7,18 +7,30 @@ using ZB.MOM.WW.LmxOpcUa.Host.MxAccess;
 
 namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
 {
+    /// <summary>
+    /// Verifies the single-threaded apartment worker used to marshal COM calls for the MXAccess bridge.
+    /// </summary>
     public class StaComThreadTests : IDisposable
     {
         private readonly StaComThread _thread;
 
+        /// <summary>
+        /// Starts a fresh STA thread instance for each test.
+        /// </summary>
         public StaComThreadTests()
         {
             _thread = new StaComThread();
             _thread.Start();
         }
 
+        /// <summary>
+        /// Disposes the STA thread after each test.
+        /// </summary>
         public void Dispose() => _thread.Dispose();
 
+        /// <summary>
+        /// Confirms that queued work runs on a thread configured for STA apartment state.
+        /// </summary>
         [Fact]
         public async Task RunAsync_ExecutesOnStaThread()
         {
@@ -26,6 +38,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             apartmentState.ShouldBe(ApartmentState.STA);
         }
 
+        /// <summary>
+        /// Confirms that action delegates run to completion on the STA thread.
+        /// </summary>
         [Fact]
         public async Task RunAsync_Action_Completes()
         {
@@ -34,6 +49,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             executed.ShouldBe(true);
         }
 
+        /// <summary>
+        /// Confirms that function delegates can return results from the STA thread.
+        /// </summary>
         [Fact]
         public async Task RunAsync_Func_ReturnsResult()
         {
@@ -41,6 +59,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             result.ShouldBe(42);
         }
 
+        /// <summary>
+        /// Confirms that exceptions thrown on the STA thread propagate back to the caller.
+        /// </summary>
         [Fact]
         public async Task RunAsync_PropagatesException()
         {
@@ -48,6 +69,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
                 _thread.RunAsync(() => throw new InvalidOperationException("test error")));
         }
 
+        /// <summary>
+        /// Confirms that disposing the STA thread stops it from accepting additional work.
+        /// </summary>
         [Fact]
         public void Dispose_Stops_Thread()
         {
@@ -59,6 +83,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             Should.Throw<ObjectDisposedException>(() => thread.RunAsync(() => { }).GetAwaiter().GetResult());
         }
 
+        /// <summary>
+        /// Confirms that multiple queued work items all execute successfully on the STA thread.
+        /// </summary>
         [Fact]
         public async Task MultipleWorkItems_ExecuteInOrder()
         {