docs(src): add missing XML docs and strip tracking-ID comments

Sweep of 203 source files resolving CommentChecker findings: add
<summary>/<param>/<returns>/<inheritdoc> where missing, and remove
resolved task/issue tracking markers (Tests-NNN, Worker-NNN, Server-NNN,
Task N) from code comments. Comment/doc-only — no logic changes.
Server+Tests build clean under TreatWarningsAsErrors.
This commit is contained in:
Joseph Doherty
2026-07-07 14:09:49 -04:00
parent 8914472706
commit fca978de07
203 changed files with 1834 additions and 1383 deletions
@@ -37,6 +37,7 @@ public sealed class MxAccessEventMapper
/// <param name="quality">Item quality code from MXAccess.</param>
/// <param name="timestamp">Item timestamp from MXAccess.</param>
/// <param name="statuses">Array of MxStatusProxy values from MXAccess.</param>
/// <returns>The mapped OnDataChange event.</returns>
public MxEvent CreateOnDataChange(
string sessionId,
int serverHandle,
@@ -65,6 +66,7 @@ public sealed class MxAccessEventMapper
/// <param name="serverHandle">Handle returned by the worker.</param>
/// <param name="itemHandle">Handle returned by the worker.</param>
/// <param name="statuses">Array of MxStatusProxy values from MXAccess.</param>
/// <returns>The mapped OnWriteComplete event.</returns>
public MxEvent CreateOnWriteComplete(
string sessionId,
int serverHandle,
@@ -87,6 +89,7 @@ public sealed class MxAccessEventMapper
/// <param name="serverHandle">Handle returned by the worker.</param>
/// <param name="itemHandle">Handle returned by the worker.</param>
/// <param name="statuses">Array of MxStatusProxy values from MXAccess.</param>
/// <returns>The mapped OperationComplete event.</returns>
public MxEvent CreateOperationComplete(
string sessionId,
int serverHandle,
@@ -133,6 +136,7 @@ public sealed class MxAccessEventMapper
/// The alarm provider that sourced this transition. Defaults to
/// <see cref="AlarmProviderMode.Alarmmgr"/> for the native path.
/// </param>
/// <returns>The mapped OnAlarmTransition event.</returns>
public MxEvent CreateOnAlarmTransition(
string sessionId,
string alarmFullReference,
@@ -194,6 +198,7 @@ public sealed class MxAccessEventMapper
/// <param name="reason">Human-readable reason for the switch.</param>
/// <param name="hresult">The COM HRESULT that triggered a failover, or 0 for a clean failback.</param>
/// <param name="atUtc">The UTC instant the switch occurred.</param>
/// <returns>The mapped OnAlarmProviderModeChanged event.</returns>
public MxEvent CreateOnAlarmProviderModeChanged(
string sessionId,
AlarmProviderMode mode,
@@ -228,6 +233,7 @@ public sealed class MxAccessEventMapper
/// <param name="quality">Array of quality values from MXAccess.</param>
/// <param name="timestamp">Array of timestamp values from MXAccess.</param>
/// <param name="statuses">Array of MxStatusProxy values from MXAccess.</param>
/// <returns>The mapped OnBufferedDataChange event.</returns>
public MxEvent CreateOnBufferedDataChange(
string sessionId,
int serverHandle,