docs: strip task-tracking IDs from code comments and fill missing XML docs
Tracking IDs are review bookkeeping that rots in shipped source; the rationale they tagged is kept. Comment-only change (CommentChecker 458 -> 16 false positives).
This commit is contained in:
@@ -624,7 +624,7 @@ public sealed class GatewayAlarmMonitorProviderModeTests
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// GWC-37: a Galaxy Repository outage at startup used to leave one <c>LogWarning</c> and an
|
||||
/// A Galaxy Repository outage at startup used to leave one <c>LogWarning</c> and an
|
||||
/// empty subtag watch-list that stayed empty for the monitor's whole life — invisible until
|
||||
/// a failover found the standby covering nothing. The condition is now a standing verdict
|
||||
/// on the provider status, so it reaches the alarm feed, the dashboard badge and every
|
||||
@@ -661,7 +661,7 @@ public sealed class GatewayAlarmMonitorProviderModeTests
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// GWC-37: the failover edge is the moment the watch-list stops being theoretical, so the
|
||||
/// The failover edge is the moment the watch-list stops being theoretical, so the
|
||||
/// monitor re-resolves it there, hot-swaps the recovered list through
|
||||
/// <c>UpdateAlarmWatchList</c>, and publishes the acknowledged verdict on the same status
|
||||
/// frame the failover produces. The update must precede the status frame so the frame never
|
||||
@@ -748,6 +748,7 @@ public sealed class GatewayAlarmMonitorProviderModeTests
|
||||
}
|
||||
|
||||
/// <summary>Periodic reconciliation applies a recovered watch list once and suppresses an unchanged resolution on the next cadence.</summary>
|
||||
/// <returns>A task that represents the asynchronous operation.</returns>
|
||||
[Fact]
|
||||
public async Task WatchListRefresh_PeriodicRecovery_SendsExactlyOneMaterialUpdate()
|
||||
{
|
||||
@@ -774,6 +775,7 @@ public sealed class GatewayAlarmMonitorProviderModeTests
|
||||
}
|
||||
|
||||
/// <summary>A rejected refresh keeps the old fingerprint and degraded verdict so the same material change is retried.</summary>
|
||||
/// <returns>A task that represents the asynchronous operation.</returns>
|
||||
[Fact]
|
||||
public async Task WatchListRefresh_WorkerRejects_RetainsFingerprintAndRetriesSameTargets()
|
||||
{
|
||||
@@ -937,7 +939,7 @@ public sealed class GatewayAlarmMonitorProviderModeTests
|
||||
/// <see cref="IAlarmWatchListResolver"/> that hands out a scripted sequence of
|
||||
/// resolutions — one per call, the last repeating — and counts the calls, so a test can
|
||||
/// drive "discovery was down at subscribe and back up by the failover" and assert that the
|
||||
/// second resolution happened at all (GWC-37).
|
||||
/// second resolution happened at all.
|
||||
/// </summary>
|
||||
/// <param name="script">Resolutions to return, in call order.</param>
|
||||
private sealed class ScriptedWatchListResolver(params AlarmWatchListResolution[] script) : IAlarmWatchListResolver
|
||||
@@ -997,6 +999,8 @@ public sealed class GatewayAlarmMonitorProviderModeTests
|
||||
_events.Writer.TryWrite(new WorkerEvent { Event = mxEvent });
|
||||
|
||||
/// <summary>Pushes a provider-mode change onto the worker event stream.</summary>
|
||||
/// <param name="mode">The provider mode being reported.</param>
|
||||
/// <param name="reason">The reason for the mode change.</param>
|
||||
public void EmitModeChange(AlarmProviderMode mode, string reason) => EmitEvent(new MxEvent
|
||||
{
|
||||
OnAlarmProviderModeChanged = new OnAlarmProviderModeChangedEvent
|
||||
@@ -1008,6 +1012,9 @@ public sealed class GatewayAlarmMonitorProviderModeTests
|
||||
});
|
||||
|
||||
/// <summary>Waits until at least the requested number of update commands have arrived.</summary>
|
||||
/// <param name="count">The minimum number of update commands to wait for.</param>
|
||||
/// <param name="timeout">The maximum time to wait.</param>
|
||||
/// <returns>A task that represents the asynchronous operation.</returns>
|
||||
public async Task WaitForUpdateCountAsync(int count, TimeSpan timeout)
|
||||
{
|
||||
await WaitUntilAsync(() => UpdateCommands.Count >= count, timeout);
|
||||
|
||||
Reference in New Issue
Block a user