docs+ui: backfill XML doc comments and finish dashboard layout pass

Adds missing <summary>/<param> XML docs across 99 server, worker, and test
files so CommentChecker reports zero issues (TreatWarningsAsErrors needs the
analyzer clean). Bundles in WIP dashboard work: NavSection extraction,
MainLayout/site.css/js styling alignment, and DashboardOptions/Auth tweaks.
This commit is contained in:
Joseph Doherty
2026-05-27 14:20:10 -04:00
parent 382861c602
commit 615b487a77
110 changed files with 1473 additions and 192 deletions
@@ -98,6 +98,12 @@ public sealed class MxAccessBaseEventSink : IMxAccessEventSink
/// Exposed <c>internal</c> so unit tests can drive the integrated
/// sink → mapper → queue path without a live MXAccess COM event source.
/// </summary>
/// <param name="hLMXServerHandle">The MXAccess server handle.</param>
/// <param name="phItemHandle">The MXAccess item handle.</param>
/// <param name="pvItemValue">The new item value.</param>
/// <param name="pwItemQuality">The item quality.</param>
/// <param name="pftItemTimeStamp">The item timestamp.</param>
/// <param name="pVars">Status array from MXAccess event.</param>
internal void OnDataChange(
int hLMXServerHandle,
int phItemHandle,
@@ -128,6 +134,9 @@ public sealed class MxAccessBaseEventSink : IMxAccessEventSink
/// Handles the MXAccess <c>OnWriteComplete</c> COM event. Exposed
/// <c>internal</c> as a unit-test seam; see <see cref="OnDataChange"/>.
/// </summary>
/// <param name="hLMXServerHandle">The MXAccess server handle.</param>
/// <param name="phItemHandle">The MXAccess item handle.</param>
/// <param name="pVars">Status array from MXAccess event.</param>
internal void OnWriteComplete(
int hLMXServerHandle,
int phItemHandle,
@@ -145,6 +154,9 @@ public sealed class MxAccessBaseEventSink : IMxAccessEventSink
/// Handles the MXAccess <c>OperationComplete</c> COM event. Exposed
/// <c>internal</c> as a unit-test seam; see <see cref="OnDataChange"/>.
/// </summary>
/// <param name="hLMXServerHandle">The MXAccess server handle.</param>
/// <param name="phItemHandle">The MXAccess item handle.</param>
/// <param name="pVars">Status array from MXAccess event.</param>
internal void OperationComplete(
int hLMXServerHandle,
int phItemHandle,
@@ -162,6 +174,13 @@ public sealed class MxAccessBaseEventSink : IMxAccessEventSink
/// Handles the MXAccess <c>OnBufferedDataChange</c> COM event. Exposed
/// <c>internal</c> as a unit-test seam; see <see cref="OnDataChange"/>.
/// </summary>
/// <param name="hLMXServerHandle">The MXAccess server handle.</param>
/// <param name="phItemHandle">The MXAccess item handle.</param>
/// <param name="dtDataType">The data type of the buffered value.</param>
/// <param name="pvItemValue">The new item value.</param>
/// <param name="pwItemQuality">The item quality.</param>
/// <param name="pftItemTimeStamp">The item timestamp.</param>
/// <param name="pVars">Status array from MXAccess event.</param>
internal void OnBufferedDataChange(
int hLMXServerHandle,
int phItemHandle,