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.Historian.Wonderware.Client/WonderwareHistorianClient.cs

@@ -36,12 +36,18 @@ public sealed class WonderwareHistorianClient : IHistorianDataSource, IAlarmHist
     ///     Creates a client over a real named-pipe connection. Tests that need an in-process
     ///     duplex pair use the <see cref="ForTests"/> factory.
     /// </summary>
+    /// <param name="options">The client connection options.</param>
+    /// <param name="logger">Optional logger for diagnostic output.</param>
     public WonderwareHistorianClient(WonderwareHistorianClientOptions options, ILogger<WonderwareHistorianClient>? logger = null)
         : this(options, ct => PipeChannel.DefaultNamedPipeConnectFactory(options, ct), logger)
     {
     }
 
     /// <summary>Test seam — inject an arbitrary connect callback.</summary>
+    /// <param name="options">The client connection options.</param>
+    /// <param name="connect">A callback that establishes the connection stream.</param>
+    /// <param name="logger">Optional logger for diagnostic output.</param>
+    /// <returns>A new WonderwareHistorianClient configured for testing.</returns>
     public static WonderwareHistorianClient ForTests(
         WonderwareHistorianClientOptions options,
         Func<CancellationToken, Task<Stream>> connect,
@@ -60,6 +66,13 @@ public sealed class WonderwareHistorianClient : IHistorianDataSource, IAlarmHist
 
     // ===== IHistorianDataSource =====
 
+    /// <summary>Asynchronously reads raw historical data for a tag within a time range.</summary>
+    /// <param name="fullReference">The full reference path of the tag to read.</param>
+    /// <param name="startUtc">The start time in UTC for the read range.</param>
+    /// <param name="endUtc">The end time in UTC for the read range.</param>
+    /// <param name="maxValuesPerNode">The maximum number of values to return.</param>
+    /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>A task that returns the historical read result.</returns>
     public async Task<HistoryReadResult> ReadRawAsync(
         string fullReference, DateTime startUtc, DateTime endUtc, uint maxValuesPerNode,
         CancellationToken cancellationToken)
@@ -78,6 +91,14 @@ public sealed class WonderwareHistorianClient : IHistorianDataSource, IAlarmHist
         return new HistoryReadResult(ToSnapshots(reply.Samples), ContinuationPoint: null);
     }
 
+    /// <summary>Asynchronously reads processed historical data with aggregation for a tag within a time range.</summary>
+    /// <param name="fullReference">The full reference path of the tag to read.</param>
+    /// <param name="startUtc">The start time in UTC for the read range.</param>
+    /// <param name="endUtc">The end time in UTC for the read range.</param>
+    /// <param name="interval">The time interval for aggregation.</param>
+    /// <param name="aggregate">The type of aggregation to apply.</param>
+    /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>A task that returns the historical read result with aggregated data.</returns>
     public async Task<HistoryReadResult> ReadProcessedAsync(
         string fullReference, DateTime startUtc, DateTime endUtc, TimeSpan interval,
         HistoryAggregateType aggregate, CancellationToken cancellationToken)
@@ -97,6 +118,11 @@ public sealed class WonderwareHistorianClient : IHistorianDataSource, IAlarmHist
         return new HistoryReadResult(ToAggregateSnapshots(reply.Buckets), ContinuationPoint: null);
     }
 
+    /// <summary>Asynchronously reads historical data at specific timestamps for a tag.</summary>
+    /// <param name="fullReference">The full reference path of the tag to read.</param>
+    /// <param name="timestampsUtc">The specific timestamps in UTC to read values for.</param>
+    /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>A task that returns the historical read result with values at the specified times.</returns>
     public async Task<HistoryReadResult> ReadAtTimeAsync(
         string fullReference, IReadOnlyList<DateTime> timestampsUtc, CancellationToken cancellationToken)
     {
@@ -158,6 +184,13 @@ public sealed class WonderwareHistorianClient : IHistorianDataSource, IAlarmHist
         return result;
     }
 
+    /// <summary>Asynchronously reads historical events within a time range.</summary>
+    /// <param name="sourceName">The source name filter for events, or null to read all sources.</param>
+    /// <param name="startUtc">The start time in UTC for the read range.</param>
+    /// <param name="endUtc">The end time in UTC for the read range.</param>
+    /// <param name="maxEvents">The maximum number of events to return.</param>
+    /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>A task that returns the historical events result.</returns>
     public async Task<HistoricalEventsResult> ReadEventsAsync(
         string? sourceName, DateTime startUtc, DateTime endUtc, int maxEvents,
         CancellationToken cancellationToken)
@@ -242,6 +275,9 @@ public sealed class WonderwareHistorianClient : IHistorianDataSource, IAlarmHist
     ///         for every event in the batch; the drain worker's backoff controls recovery.
     ///     </para>
     /// </remarks>
+    /// <param name="batch">The batch of alarm historian events to write.</param>
+    /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>A task that returns per-event write outcomes.</returns>
     public async Task<IReadOnlyList<HistorianWriteOutcome>> WriteBatchAsync(
         IReadOnlyList<AlarmHistorianEvent> batch, CancellationToken cancellationToken)
     {
@@ -485,6 +521,8 @@ public sealed class WonderwareHistorianClient : IHistorianDataSource, IAlarmHist
         _ => throw new NotSupportedException($"Unknown HistoryAggregateType {aggregate}"),
     };
 
+    /// <summary>Asynchronously disposes the client and its underlying pipe channel.</summary>
+    /// <returns>A task that completes when the client has been disposed.</returns>
     public ValueTask DisposeAsync() => _channel.DisposeAsync();
 
     /// <summary>