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/Backend/HistorianDataSource.cs

@@ -40,9 +40,15 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
 
         private readonly HistorianClusterEndpointPicker _picker;
 
+        /// <summary>Initializes a new instance of the <see cref="HistorianDataSource"/> class with the default connection factory.</summary>
+        /// <param name="config">The historian configuration.</param>
         public HistorianDataSource(HistorianConfiguration config)
             : this(config, new SdkHistorianConnectionFactory(), null) { }
 
+        /// <summary>Initializes a new instance of the <see cref="HistorianDataSource"/> class with the specified connection factory and endpoint picker.</summary>
+        /// <param name="config">The historian configuration.</param>
+        /// <param name="factory">The historian connection factory.</param>
+        /// <param name="picker">The optional cluster endpoint picker.</param>
         internal HistorianDataSource(
             HistorianConfiguration config,
             IHistorianConnectionFactory factory,
@@ -76,6 +82,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
         ///     <em>connection</em> (rather than the query payload) is the problem and the
         ///     shared SDK connection should therefore be reset. Internal for unit testing.
         /// </summary>
+        /// <param name="code">The historian access error code.</param>
         internal static bool IsConnectionClassError(HistorianAccessError.ErrorValue code)
             => ConnectionErrorCodes.Contains(code);
 
@@ -88,6 +95,8 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
         ///     single pipe-server connection thread indefinitely. See
         ///     Driver.Historian.Wonderware-010.
         /// </summary>
+        /// <param name="cfg">The historian configuration.</param>
+        /// <param name="ct">The cancellation token.</param>
         internal static CancellationTokenSource BuildRequestCts(HistorianConfiguration cfg, CancellationToken ct)
         {
             var cts = CancellationTokenSource.CreateLinkedTokenSource(ct);
@@ -151,6 +160,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
             };
         }
 
+        /// <summary>Gets a snapshot of the current health status.</summary>
         public HistorianHealthSnapshot GetHealthSnapshot()
         {
             var nodeStates = _picker.SnapshotNodeStates();
@@ -309,7 +319,11 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
         /// </summary>
         internal sealed class QueryClassStartQueryException : InvalidOperationException
         {
+            /// <summary>Gets the error code that caused the exception.</summary>
             public HistorianAccessError.ErrorValue Code { get; }
+            /// <summary>Initializes a new instance of the <see cref="QueryClassStartQueryException"/> class.</summary>
+            /// <param name="message">The exception message.</param>
+            /// <param name="code">The historian access error code.</param>
             public QueryClassStartQueryException(string message, HistorianAccessError.ErrorValue code)
                 : base(message)
             {
@@ -382,6 +396,12 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
             }
         }
 
+        /// <summary>Reads raw historical samples for the specified tag.</summary>
+        /// <param name="tagName">The tag name.</param>
+        /// <param name="startTime">The start time for the query.</param>
+        /// <param name="endTime">The end time for the query.</param>
+        /// <param name="maxValues">The maximum number of values to return.</param>
+        /// <param name="ct">Cancellation token for the operation.</param>
         public Task<List<HistorianSample>> ReadRawAsync(
             string tagName, DateTime startTime, DateTime endTime, int maxValues,
             CancellationToken ct = default)
@@ -465,6 +485,13 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
             return Task.FromResult(results);
         }
 
+        /// <summary>Reads aggregate historical samples for the specified tag.</summary>
+        /// <param name="tagName">The tag name.</param>
+        /// <param name="startTime">The start time for the query.</param>
+        /// <param name="endTime">The end time for the query.</param>
+        /// <param name="intervalMs">The interval in milliseconds.</param>
+        /// <param name="aggregateColumn">The aggregate column name.</param>
+        /// <param name="ct">Cancellation token for the operation.</param>
         public Task<List<HistorianAggregateSample>> ReadAggregateAsync(
             string tagName, DateTime startTime, DateTime endTime,
             double intervalMs, string aggregateColumn,
@@ -545,6 +572,10 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
             return Task.FromResult(results);
         }
 
+        /// <summary>Reads historical samples at specific timestamps for the specified tag.</summary>
+        /// <param name="tagName">The tag name.</param>
+        /// <param name="timestamps">The timestamps to read.</param>
+        /// <param name="ct">Cancellation token for the operation.</param>
         public Task<List<HistorianSample>> ReadAtTimeAsync(
             string tagName, DateTime[] timestamps,
             CancellationToken ct = default)
@@ -627,6 +658,12 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
             return Task.FromResult(results);
         }
 
+        /// <summary>Reads historical events within the specified time range.</summary>
+        /// <param name="sourceName">The optional event source name filter.</param>
+        /// <param name="startTime">The start time for the query.</param>
+        /// <param name="endTime">The end time for the query.</param>
+        /// <param name="maxEvents">The maximum number of events to return.</param>
+        /// <param name="ct">Cancellation token for the operation.</param>
         public Task<List<HistorianEventDto>> ReadEventsAsync(
             string? sourceName, DateTime startTime, DateTime endTime, int maxEvents,
             CancellationToken ct = default)
@@ -726,6 +763,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
         ///         as a string; this is a known edge case of the SDK binding.
         ///     </para>
         /// </summary>
+        /// <param name="result">The history query result.</param>
         internal static object? SelectValue(HistoryQueryResult result)
             => SelectValueFromPair(result.Value, result.StringValue);
 
@@ -735,6 +773,8 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
         ///     <see cref="HistoryQueryResult"/> (whose internal property initialisers make
         ///     it impractical to fake). See Driver.Historian.Wonderware-012.
         /// </summary>
+        /// <param name="value">The numeric value.</param>
+        /// <param name="stringValue">The string value.</param>
         internal static object? SelectValueFromPair(double value, string? stringValue)
         {
             if (!string.IsNullOrEmpty(stringValue) && value == 0)
@@ -742,6 +782,9 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
             return value;
         }
 
+        /// <summary>Extracts the specified aggregate value from an analog summary query result.</summary>
+        /// <param name="result">The analog summary query result.</param>
+        /// <param name="column">The aggregate column name.</param>
         internal static double? ExtractAggregateValue(AnalogSummaryQueryResult result, string column)
         {
             switch (column)
@@ -757,6 +800,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware.Backend
             }
         }
 
+        /// <summary>Disposes the historian data source and releases its resources.</summary>
         public void Dispose()
         {
             if (_disposed) return;