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.

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/Drivers/DeploymentArtifact.cs

@@ -28,6 +28,7 @@ public static class DeploymentArtifact
     ///     Parse a deployment artifact blob into the list of driver-instance specs to spawn.
     ///     Empty / malformed blobs return an empty list — callers log + treat as "no drivers".
     /// </summary>
+    /// <param name="blob">The deployment artifact blob to parse.</param>
     public static IReadOnlyList<DriverInstanceSpec> ParseDriverInstances(ReadOnlySpan<byte> blob)
     {
         if (blob.IsEmpty) return Array.Empty<DriverInstanceSpec>();
@@ -87,6 +88,7 @@ public static class DeploymentArtifact
     ///     subset of fields per entity class to drive the address-space rebuild on driver-role
     ///     nodes.
     /// </summary>
+    /// <param name="blob">The deployment artifact blob to parse.</param>
     public static Phase7CompositionResult ParseComposition(ReadOnlySpan<byte> blob)
     {
         if (blob.IsEmpty) return Empty();

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/Drivers/DriverHostActor.cs

@@ -54,6 +54,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
 
     private sealed record ChildEntry(IActorRef Actor, string DriverType, string LastConfigJson, bool Stubbed);
 
+    /// <inheritdoc />
     public ITimerScheduler Timers { get; set; } = null!;
 
     public sealed class RetryConfigDbConnection
@@ -62,6 +63,14 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         private RetryConfigDbConnection() { }
     }
 
+    /// <summary>Creates props for a DriverHostActor with the specified dependencies.</summary>
+    /// <param name="dbFactory">Database context factory for configuration database access.</param>
+    /// <param name="localNode">The local cluster node identifier.</param>
+    /// <param name="coordinator">Optional coordinator actor reference for deployment coordination.</param>
+    /// <param name="driverFactory">Optional driver factory; defaults to null factory if not provided.</param>
+    /// <param name="localRoles">Optional set of roles assigned to the local node.</param>
+    /// <param name="dependencyMux">Optional actor reference for dependency multiplexing.</param>
+    /// <param name="opcUaPublishActor">Optional actor reference for OPC UA publishing.</param>
     public static Props Props(
         IDbContextFactory<OtOpcUaConfigDbContext> dbFactory,
         CommonsNodeId localNode,
@@ -73,6 +82,14 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         Akka.Actor.Props.Create(() => new DriverHostActor(
             dbFactory, localNode, coordinator, driverFactory, localRoles, dependencyMux, opcUaPublishActor));
 
+    /// <summary>Initializes a new DriverHostActor with the specified dependencies.</summary>
+    /// <param name="dbFactory">Database context factory for configuration database access.</param>
+    /// <param name="localNode">The local cluster node identifier.</param>
+    /// <param name="coordinator">Optional coordinator actor reference for deployment coordination.</param>
+    /// <param name="driverFactory">Optional driver factory; defaults to null factory if not provided.</param>
+    /// <param name="localRoles">Optional set of roles assigned to the local node.</param>
+    /// <param name="dependencyMux">Optional actor reference for dependency multiplexing.</param>
+    /// <param name="opcUaPublishActor">Optional actor reference for OPC UA publishing.</param>
     public DriverHostActor(
         IDbContextFactory<OtOpcUaConfigDbContext> dbFactory,
         CommonsNodeId localNode,
@@ -94,6 +111,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         Become(Steady);
     }
 
+    /// <inheritdoc />
     protected override void PreStart()
     {
         // Subscribe to deployments topic so the coordinator's broadcast lands here.
@@ -389,14 +407,25 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
     /// </summary>
     private sealed class StubbedDriver : IDriver
     {
+        /// <inheritdoc />
         public string DriverInstanceId { get; }
+        /// <inheritdoc />
         public string DriverType { get; }
+        /// <summary>Initializes a new stubbed driver with the specified ID and type.</summary>
+        /// <param name="id">The driver instance identifier.</param>
+        /// <param name="type">The driver type name.</param>
         public StubbedDriver(string id, string type) { DriverInstanceId = id; DriverType = type; }
+        /// <inheritdoc />
         public Task InitializeAsync(string driverConfigJson, CancellationToken cancellationToken) => Task.CompletedTask;
+        /// <inheritdoc />
         public Task ReinitializeAsync(string driverConfigJson, CancellationToken cancellationToken) => Task.CompletedTask;
+        /// <inheritdoc />
         public Task ShutdownAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+        /// <inheritdoc />
         public DriverHealth GetHealth() => new(DriverState.Healthy, DateTime.UtcNow, LastError: null);
+        /// <inheritdoc />
         public long GetMemoryFootprint() => 0;
+        /// <inheritdoc />
         public Task FlushOptionalCachesAsync(CancellationToken cancellationToken) => Task.CompletedTask;
     }
 

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/Drivers/DriverInstanceActor.cs

@@ -59,8 +59,17 @@ public sealed class DriverInstanceActor : ReceiveActor, IWithTimers
     private ISubscriptionHandle? _subscriptionHandle;
     private EventHandler<DataChangeEventArgs>? _dataChangeHandler;
 
+    /// <summary>
+    /// Gets or sets the timer scheduler for scheduling reconnection attempts.
+    /// </summary>
     public ITimerScheduler Timers { get; set; } = null!;
 
+    /// <summary>
+    /// Creates a Props object for instantiating a <see cref="DriverInstanceActor"/>.
+    /// </summary>
+    /// <param name="driver">The driver instance to wrap.</param>
+    /// <param name="reconnectInterval">Optional interval for reconnection attempts; defaults to 10 seconds.</param>
+    /// <param name="startStubbed">If true, the actor starts in stub mode for testing or unavailable platforms.</param>
     public static Props Props(IDriver driver, TimeSpan? reconnectInterval = null, bool startStubbed = false) =>
         Akka.Actor.Props.Create(() => new DriverInstanceActor(driver, reconnectInterval ?? DefaultReconnectInterval, startStubbed));
 
@@ -76,6 +85,8 @@ public sealed class DriverInstanceActor : ReceiveActor, IWithTimers
     /// The v2 <c>"GalaxyMxGateway"</c> driver talks gRPC to an external mxaccessgw process,
     /// so it runs on any platform .NET 10 supports — Linux containers included. Not stubbed.
     /// </summary>
+    /// <param name="driverType">The type identifier of the driver.</param>
+    /// <param name="roles">Operational roles configured for this instance.</param>
     public static bool ShouldStub(string driverType, IEnumerable<string> roles)
     {
         var isWindowsOnly = driverType is "Galaxy" or "Historian.Wonderware";
@@ -84,6 +95,12 @@ public sealed class DriverInstanceActor : ReceiveActor, IWithTimers
         return false;
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="DriverInstanceActor"/> class.
+    /// </summary>
+    /// <param name="driver">The driver instance to wrap and manage.</param>
+    /// <param name="reconnectInterval">Interval between reconnection attempts.</param>
+    /// <param name="startStubbed">If true, start in stub mode for testing or unavailable platforms.</param>
     public DriverInstanceActor(IDriver driver, TimeSpan reconnectInterval, bool startStubbed = false)
     {
         _driver = driver;
@@ -319,6 +336,7 @@ public sealed class DriverInstanceActor : ReceiveActor, IWithTimers
 
     private static bool IsGoodStatus(uint statusCode) => (statusCode >> 30) == 0;
 
+    /// <inheritdoc />
     protected override void PostStop()
     {
         DetachSubscription();

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/Drivers/DriverSpawnPlan.cs

@@ -21,6 +21,8 @@ public static class DriverSpawnPlanner
     ///     treated as "not desired here": if a child exists for the id it goes into ToStop,
     ///     otherwise the row is dropped entirely (no spawn for a disabled driver).
     /// </summary>
+    /// <param name="current">The currently running driver children keyed by ID.</param>
+    /// <param name="target">The target driver instances from the deployment artifact.</param>
     public static DriverSpawnPlan Compute(
         IReadOnlyDictionary<string, DriverChildSnapshot> current,
         IReadOnlyList<DriverInstanceSpec> target)