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/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests/Drivers/DriverInstanceActorTests.cs

@@ -11,6 +11,7 @@ namespace ZB.MOM.WW.OtOpcUa.Runtime.Tests.Drivers;
 
 public sealed class DriverInstanceActorTests : RuntimeActorTestBase
 {
+    /// <summary>Verifies that ApplyDelta calls ReinitializeAsync when connected and replies success.</summary>
     [Fact]
     public async Task ApplyDelta_when_Connected_calls_ReinitializeAsync_and_replies_success()
     {
@@ -32,6 +33,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
         driver.ReinitializeCount.ShouldBe(1);
     }
 
+    /// <summary>Verifies that initialize failure keeps the actor in Reconnecting state.</summary>
     [Fact]
     public void Initialize_failure_keeps_actor_in_Reconnecting_state()
     {
@@ -45,6 +47,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
         AwaitCondition(() => driver.InitializeCount >= 3, TimeSpan.FromSeconds(2));
     }
 
+    /// <summary>Verifies that writing to a non-IWritable driver returns failure.</summary>
     [Fact]
     public async Task Write_against_non_IWritable_driver_returns_failure()
     {
@@ -62,6 +65,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
         reply.Reason!.ShouldContain("IWritable");
     }
 
+    /// <summary>Verifies that writing to an IWritable driver returns success when status is Good.</summary>
     [Fact]
     public async Task Write_against_IWritable_returns_success_when_status_is_Good()
     {
@@ -80,6 +84,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
         driver.Writes.Single().Value.ShouldBe(42);
     }
 
+    /// <summary>Verifies that write propagates status code on Bad result.</summary>
     [Fact]
     public async Task Write_propagates_status_code_on_Bad_result()
     {
@@ -98,6 +103,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
         reply.Reason!.ShouldContain("80340000");
     }
 
+    /// <summary>Verifies that subscribing to an ISubscribable driver forwards OnDataChange to parent.</summary>
     [Fact]
     public async Task Subscribe_against_ISubscribable_forwards_OnDataChange_to_parent()
     {
@@ -122,6 +128,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
         published.Quality.ShouldBe(OpcUaQuality.Good);
     }
 
+    /// <summary>Verifies that subscribe translates OPC UA status severity bits to OpcUaQuality.</summary>
     [Fact]
     public async Task Subscribe_translates_OPC_UA_status_severity_bits_to_OpcUaQuality()
     {
@@ -145,6 +152,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
         parent.ExpectMsg<DriverInstanceActor.AttributeValuePublished>().Quality.ShouldBe(OpcUaQuality.Bad);
     }
 
+    /// <summary>Verifies that subscribing to a non-ISubscribable driver replies with failure.</summary>
     [Fact]
     public async Task Subscribe_against_non_ISubscribable_replies_with_failure()
     {
@@ -161,6 +169,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
         reply.Reason.ShouldContain("ISubscribable");
     }
 
+    /// <summary>Verifies that DisconnectObserved detaches subscription handler so late events are dropped.</summary>
     [Fact]
     public async Task DisconnectObserved_detaches_subscription_handler_so_late_events_are_dropped()
     {
@@ -185,13 +194,21 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
 
     private class StubDriver : IDriver
     {
+        /// <summary>Gets or sets a value indicating whether initialization should throw.</summary>
         public bool InitializeShouldThrow { get; set; }
+        /// <summary>Gets the number of times initialization was called.</summary>
         public int InitializeCount;
+        /// <summary>Gets the number of times reinitialization was called.</summary>
         public int ReinitializeCount;
 
+        /// <summary>Gets the driver instance ID.</summary>
         public string DriverInstanceId => "stub-driver-1";
+        /// <summary>Gets the driver type.</summary>
         public string DriverType => "Stub";
 
+        /// <summary>Initializes the driver with the specified configuration JSON.</summary>
+        /// <param name="driverConfigJson">The driver configuration JSON.</param>
+        /// <param name="cancellationToken">Cancellation token for the operation.</param>
         public Task InitializeAsync(string driverConfigJson, CancellationToken cancellationToken)
         {
             Interlocked.Increment(ref InitializeCount);
@@ -199,23 +216,37 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
             return Task.CompletedTask;
         }
 
+        /// <summary>Reinitializes the driver with the specified configuration JSON.</summary>
+        /// <param name="driverConfigJson">The driver configuration JSON.</param>
+        /// <param name="cancellationToken">Cancellation token for the operation.</param>
         public Task ReinitializeAsync(string driverConfigJson, CancellationToken cancellationToken)
         {
             Interlocked.Increment(ref ReinitializeCount);
             return Task.CompletedTask;
         }
 
+        /// <summary>Shuts down the driver.</summary>
+        /// <param name="cancellationToken">Cancellation token for the operation.</param>
         public Task ShutdownAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+        /// <summary>Gets the health status of the driver.</summary>
         public DriverHealth GetHealth() => new(DriverState.Healthy, DateTime.UtcNow, null);
+        /// <summary>Gets the memory footprint of the driver.</summary>
         public long GetMemoryFootprint() => 0;
+        /// <summary>Flushes optional caches in the driver.</summary>
+        /// <param name="cancellationToken">Cancellation token for the operation.</param>
         public Task FlushOptionalCachesAsync(CancellationToken cancellationToken) => Task.CompletedTask;
     }
 
     private sealed class WritableStubDriver : StubDriver, IWritable
     {
+        /// <summary>Gets or sets the next status code to return from write operations.</summary>
         public uint NextStatusCode { get; set; } = 0u;
+        /// <summary>Gets the list of write requests received.</summary>
         public List<WriteRequest> Writes { get; } = new();
 
+        /// <summary>Writes the specified requests.</summary>
+        /// <param name="writes">The write requests.</param>
+        /// <param name="cancellationToken">Cancellation token for the operation.</param>
         public Task<IReadOnlyList<WriteResult>> WriteAsync(
             IReadOnlyList<WriteRequest> writes, CancellationToken cancellationToken)
         {
@@ -227,19 +258,32 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
 
     private sealed class SubscribableStubDriver : StubDriver, ISubscribable
     {
+        /// <summary>Occurs when data changes.</summary>
         public event EventHandler<DataChangeEventArgs>? OnDataChange;
 
         private readonly StubHandle _handle = new();
 
+        /// <summary>Gets the number of subscribers to OnDataChange.</summary>
         public int OnDataChangeSubscriberCount => OnDataChange?.GetInvocationList().Length ?? 0;
 
+        /// <summary>Subscribes to the specified full references.</summary>
+        /// <param name="fullReferences">The full references to subscribe to.</param>
+        /// <param name="publishingInterval">The publishing interval.</param>
+        /// <param name="cancellationToken">Cancellation token for the operation.</param>
         public Task<ISubscriptionHandle> SubscribeAsync(
             IReadOnlyList<string> fullReferences, TimeSpan publishingInterval, CancellationToken cancellationToken)
             => Task.FromResult<ISubscriptionHandle>(_handle);
 
+        /// <summary>Unsubscribes from the specified subscription handle.</summary>
+        /// <param name="handle">The subscription handle.</param>
+        /// <param name="cancellationToken">Cancellation token for the operation.</param>
         public Task UnsubscribeAsync(ISubscriptionHandle handle, CancellationToken cancellationToken)
             => Task.CompletedTask;
 
+        /// <summary>Fires a data change event with the specified parameters.</summary>
+        /// <param name="fullRef">The full reference of the data that changed.</param>
+        /// <param name="value">The new value.</param>
+        /// <param name="statusCode">The OPC UA status code.</param>
         public void FireDataChange(string fullRef, object? value, uint statusCode)
         {
             var snapshot = new DataValueSnapshot(value, statusCode, DateTime.UtcNow, DateTime.UtcNow);
@@ -248,6 +292,7 @@ public sealed class DriverInstanceActorTests : RuntimeActorTestBase
 
         private sealed class StubHandle : ISubscriptionHandle
         {
+            /// <summary>Gets the diagnostic ID of the subscription.</summary>
             public string DiagnosticId => "stub-sub";
         }
     }