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.AdminUI/Clients/AdminOperationsClient.cs

@@ -18,11 +18,17 @@ public sealed class AdminOperationsClient : IAdminOperationsClient
 
     private readonly IActorRef _proxy;
 
+    /// <summary>Initializes a new instance of the AdminOperationsClient.</summary>
+    /// <param name="registry">The actor registry to resolve the admin operations singleton proxy.</param>
     public AdminOperationsClient(ActorRegistry registry)
     {
         _proxy = registry.Get<AdminOperationsActorKey>();
     }
 
+    /// <summary>Starts a deployment via the admin operations actor.</summary>
+    /// <param name="createdBy">The username of who initiated the deployment.</param>
+    /// <param name="ct">The cancellation token.</param>
+    /// <returns>The deployment start result.</returns>
     public async Task<StartDeploymentResult> StartDeploymentAsync(string createdBy, CancellationToken ct)
     {
         var msg = new StartDeployment(createdBy, CorrelationId.NewId());

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/Clients/FleetDiagnosticsClient.cs

@@ -22,12 +22,19 @@ public sealed class FleetDiagnosticsClient : IFleetDiagnosticsClient
     private readonly ActorSystem _system;
     private readonly string _systemName;
 
+    /// <summary>Initializes a new FleetDiagnosticsClient with the given actor system and cluster options.</summary>
+    /// <param name="system">The Akka actor system.</param>
+    /// <param name="options">Cluster configuration options.</param>
     public FleetDiagnosticsClient(ActorSystem system, IOptions<AkkaClusterOptions> options)
     {
         _system = system;
         _systemName = options.Value.SystemName;
     }
 
+    /// <summary>Gets diagnostics for a cluster node.</summary>
+    /// <param name="nodeId">The node identifier to query.</param>
+    /// <param name="ct">Cancellation token.</param>
+    /// <returns>Diagnostics snapshot for the node, or an empty snapshot if the query fails.</returns>
     public async Task<NodeDiagnosticsSnapshot> GetDiagnosticsAsync(NodeId nodeId, CancellationToken ct)
     {
         var selection = _system.ActorSelection($"akka.tcp://{_systemName}@{nodeId.Value}/user/driver-host");

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/Clients/ServiceCollectionExtensions.cs

@@ -3,8 +3,13 @@ using ZB.MOM.WW.OtOpcUa.Commons.Interfaces;
 
 namespace ZB.MOM.WW.OtOpcUa.AdminUI.Clients;
 
+/// <summary>Service collection extensions for Admin UI client registration.</summary>
 public static class ServiceCollectionExtensions
 {
+    /// <summary>
+    ///     Registers the Admin UI client services in the dependency injection container.
+    /// </summary>
+    /// <param name="services">The service collection to register clients into.</param>
     public static IServiceCollection AddOtOpcUaAdminClients(this IServiceCollection services)
     {
         services.AddScoped<IAdminOperationsClient, AdminOperationsClient>();

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/EndpointRouteBuilderExtensions.cs

@@ -17,6 +17,8 @@ public static class EndpointRouteBuilderExtensions
     /// Blazor pipeline but the only built-in components are the v2-native ones added in this
     /// library (e.g. <c>Deployments</c>, Task 52).
     /// </summary>
+    /// <typeparam name="TApp">The root component type for Razor pages.</typeparam>
+    /// <param name="app">The endpoint route builder.</param>
     public static IEndpointRouteBuilder MapAdminUI<TApp>(this IEndpointRouteBuilder app)
         where TApp : IComponent
     {
@@ -28,6 +30,10 @@ public static class EndpointRouteBuilderExtensions
         return app;
     }
 
+    /// <summary>
+    /// Adds AdminUI services to the dependency injection container.
+    /// </summary>
+    /// <param name="services">The service collection.</param>
     public static IServiceCollection AddAdminUI(this IServiceCollection services)
     {
         services.AddRazorComponents().AddInteractiveServerComponents();

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/Hubs/AlertSignalRBridge.cs

@@ -19,9 +19,17 @@ public sealed class AlertSignalRBridge : ReceiveActor
     private readonly IHubContext<AlertHub> _hub;
     private readonly ILoggingAdapter _log = Context.GetLogger();
 
+    /// <summary>
+    /// Creates actor props for the AlertSignalRBridge.
+    /// </summary>
+    /// <param name="hub">The SignalR hub context to send alerts to.</param>
     public static Props Props(IHubContext<AlertHub> hub) =>
         Akka.Actor.Props.Create(() => new AlertSignalRBridge(hub));
 
+    /// <summary>
+    /// Initializes a new instance of the AlertSignalRBridge actor.
+    /// </summary>
+    /// <param name="hub">The SignalR hub context to send alerts to.</param>
     public AlertSignalRBridge(IHubContext<AlertHub> hub)
     {
         _hub = hub;
@@ -29,6 +37,7 @@ public sealed class AlertSignalRBridge : ReceiveActor
         Receive<SubscribeAck>(_ => { /* DPS confirmation */ });
     }
 
+    /// <inheritdoc />
     protected override void PreStart() =>
         DistributedPubSub.Get(Context.System).Mediator.Tell(new Subscribe(TopicName, Self));
 

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/Hubs/FleetStatusSignalRBridge.cs

@@ -25,9 +25,14 @@ public sealed class FleetStatusSignalRBridge : ReceiveActor
     private readonly IHubContext<FleetStatusHub> _hub;
     private readonly ILoggingAdapter _log = Context.GetLogger();
 
+    /// <summary>Creates actor props for a FleetStatusSignalRBridge with the specified hub context.</summary>
+    /// <param name="hub">The SignalR hub context.</param>
+    /// <returns>Props for creating a new FleetStatusSignalRBridge actor.</returns>
     public static Props Props(IHubContext<FleetStatusHub> hub) =>
         Akka.Actor.Props.Create(() => new FleetStatusSignalRBridge(hub));
 
+    /// <summary>Initializes a new instance of the FleetStatusSignalRBridge class.</summary>
+    /// <param name="hub">The SignalR hub context for sending messages to clients.</param>
     public FleetStatusSignalRBridge(IHubContext<FleetStatusHub> hub)
     {
         _hub = hub;
@@ -35,6 +40,7 @@ public sealed class FleetStatusSignalRBridge : ReceiveActor
         Receive<SubscribeAck>(_ => { /* DPS confirmation */ });
     }
 
+    /// <inheritdoc />
     protected override void PreStart() =>
         DistributedPubSub.Get(Context.System).Mediator.Tell(new Subscribe(TopicName, Self));
 

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/Hubs/HubRouteBuilderExtensions.cs

@@ -3,8 +3,13 @@ using Microsoft.AspNetCore.Routing;
 
 namespace ZB.MOM.WW.OtOpcUa.AdminUI.Hubs;
 
+/// <summary>Extension methods for mapping OtOpcUa SignalR hubs to routes.</summary>
 public static class HubRouteBuilderExtensions
 {
+    /// <summary>
+    ///     Maps all OtOpcUa Admin UI SignalR hubs to their configured endpoints.
+    /// </summary>
+    /// <param name="app">The endpoint route builder to register hubs on.</param>
     public static IEndpointRouteBuilder MapOtOpcUaHubs(this IEndpointRouteBuilder app)
     {
         app.MapHub<FleetStatusHub>(FleetStatusHub.Endpoint);

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/Hubs/HubServiceCollectionExtensions.cs

@@ -25,6 +25,7 @@ public static class HubServiceCollectionExtensions
     /// }
     /// </code>
     /// </summary>
+    /// <param name="builder">The Akka configuration builder.</param>
     public static AkkaConfigurationBuilder WithOtOpcUaSignalRBridges(this AkkaConfigurationBuilder builder)
     {
         builder.WithActors((system, registry, resolver) =>

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/Hubs/ScriptLogSignalRBridge.cs

@@ -17,9 +17,13 @@ public sealed class ScriptLogSignalRBridge : ReceiveActor
     private readonly IHubContext<ScriptLogHub> _hub;
     private readonly ILoggingAdapter _log = Context.GetLogger();
 
+    /// <summary>Creates a Props instance for the ScriptLogSignalRBridge.</summary>
+    /// <param name="hub">The SignalR hub context for sending messages to clients.</param>
     public static Props Props(IHubContext<ScriptLogHub> hub) =>
         Akka.Actor.Props.Create(() => new ScriptLogSignalRBridge(hub));
 
+    /// <summary>Initializes a new instance of the <see cref="ScriptLogSignalRBridge"/> class.</summary>
+    /// <param name="hub">The SignalR hub context for sending messages to clients.</param>
     public ScriptLogSignalRBridge(IHubContext<ScriptLogHub> hub)
     {
         _hub = hub;
@@ -27,6 +31,7 @@ public sealed class ScriptLogSignalRBridge : ReceiveActor
         Receive<SubscribeAck>(_ => { /* DPS confirmation */ });
     }
 
+    /// <inheritdoc />
     protected override void PreStart() =>
         DistributedPubSub.Get(Context.System).Mediator.Tell(new Subscribe(TopicName, Self));