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/Drivers/ZB.MOM.WW.OtOpcUa.Driver.FOCAS/FocasAlarmProjection.cs

@@ -28,6 +28,10 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
     private readonly Lock _subsLock = new();
     private long _nextId;
 
+    /// <summary>Initializes a new FOCAS alarm projection.</summary>
+    /// <param name="driver">FOCAS driver instance.</param>
+    /// <param name="pollInterval">Polling interval.</param>
+    /// <param name="logger">Optional logger.</param>
     public FocasAlarmProjection(FocasDriver driver, TimeSpan pollInterval, ILogger? logger = null)
     {
         _driver = driver;
@@ -35,6 +39,10 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
         _logger = logger ?? NullLogger.Instance;
     }
 
+    /// <summary>Subscribes to alarms from the specified device sources.</summary>
+    /// <param name="sourceNodeIds">Source node IDs to listen to.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>A task returning the alarm subscription handle.</returns>
     public Task<IAlarmSubscriptionHandle> SubscribeAsync(
         IReadOnlyList<string> sourceNodeIds, CancellationToken cancellationToken)
     {
@@ -54,6 +62,10 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
         return Task.FromResult<IAlarmSubscriptionHandle>(handle);
     }
 
+    /// <summary>Unsubscribes from an alarm subscription.</summary>
+    /// <param name="handle">Alarm subscription handle.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>A task representing the asynchronous operation.</returns>
     public async Task UnsubscribeAsync(IAlarmSubscriptionHandle handle, CancellationToken cancellationToken)
     {
         if (handle is not FocasAlarmSubscriptionHandle h) return;
@@ -74,10 +86,15 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
     ///     condition resolves. Swallow the request so capability negotiation succeeds, rather
     ///     than surfacing a confusing "not supported" error to the operator.
     /// </summary>
+    /// <param name="acknowledgements">Alarms to acknowledge.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>A completed task.</returns>
     public Task AcknowledgeAsync(
         IReadOnlyList<AlarmAcknowledgeRequest> acknowledgements, CancellationToken cancellationToken) =>
         Task.CompletedTask;
 
+    /// <summary>Disposes the alarm projection.</summary>
+    /// <returns>A task representing the asynchronous operation.</returns>
     public async ValueTask DisposeAsync()
     {
         List<Subscription> snap;
@@ -97,6 +114,9 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
     ///     emits raise + clear events. Extracted so tests can drive a tick without spinning up
     ///     the full Task.Run loop.
     /// </summary>
+    /// <param name="sub">Active subscription.</param>
+    /// <param name="deviceHostAddress">Device host address.</param>
+    /// <param name="current">Current alarms from the device.</param>
     internal void Tick(Subscription sub, string deviceHostAddress, IReadOnlyList<FocasActiveAlarm> current)
     {
         var prev = sub.LastByDevice.GetValueOrDefault(deviceHostAddress) ?? [];
@@ -158,6 +178,8 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
     private static string AlarmKey(FocasActiveAlarm a) => $"{a.Type}:{a.AlarmNumber}";
 
     /// <summary>Map FOCAS type to a human-readable category; falls back to the numeric type.</summary>
+    /// <param name="type">FOCAS alarm type.</param>
+    /// <returns>The mapped alarm type string.</returns>
     internal static string MapAlarmType(short type) => type switch
     {
         FocasAlarmType.Parameter   => "Parameter",
@@ -176,6 +198,8 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
     ///     Servo / Emergency-equivalents are Critical; Parameter + Macro are Medium; rest land
     ///     at High (everything else on a CNC is safety-relevant).
     /// </summary>
+    /// <param name="type">FOCAS alarm type.</param>
+    /// <returns>The mapped alarm severity.</returns>
     internal static AlarmSeverity MapSeverity(short type) => type switch
     {
         FocasAlarmType.Overtravel => AlarmSeverity.Critical,
@@ -191,10 +215,15 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
         HashSet<string>? deviceFilter,
         CancellationTokenSource cts)
     {
+        /// <summary>Gets the subscription handle.</summary>
         public FocasAlarmSubscriptionHandle Handle { get; } = handle;
+        /// <summary>Gets the device filter.</summary>
         public HashSet<string>? DeviceFilter { get; } = deviceFilter;
+        /// <summary>Gets the cancellation token source.</summary>
         public CancellationTokenSource Cts { get; } = cts;
+        /// <summary>Gets or sets the polling loop task.</summary>
         public Task Loop { get; set; } = Task.CompletedTask;
+        /// <summary>Gets the last seen alarms by device.</summary>
         public Dictionary<string, IReadOnlyList<FocasActiveAlarm>> LastByDevice { get; } =
             new(StringComparer.OrdinalIgnoreCase);
     }
@@ -203,5 +232,6 @@ internal sealed class FocasAlarmProjection : IAsyncDisposable
 /// <summary>Handle returned by <see cref="FocasAlarmProjection.SubscribeAsync"/>.</summary>
 public sealed record FocasAlarmSubscriptionHandle(long Id) : IAlarmSubscriptionHandle
 {
+    /// <summary>Gets the diagnostic identifier for this subscription.</summary>
     public string DiagnosticId => $"focas-alarm-sub-{Id}";
 }