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:
+4
-6
@@ -171,13 +171,11 @@ public sealed class DashboardBrowseAndAlarmModelTests
|
||||
Assert.True(model.IsDegraded);
|
||||
Assert.Contains("bg-warning", model.BadgeCssClass, StringComparison.Ordinal);
|
||||
Assert.Equal("x", model.Reason);
|
||||
// Tests-033: pin the amber label text, not just the CSS class — a label swap
|
||||
// would otherwise pass this test.
|
||||
Assert.Equal(DashboardAlarmProviderStatus.DegradedLabel, model.Label);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Tests-033: an explicitly-degraded status whose mode is still Alarmmgr (the
|
||||
/// An explicitly-degraded status whose mode is still Alarmmgr (the
|
||||
/// <c>Degraded || Mode==Subtag</c> guard's second, independent branch) must still
|
||||
/// map to the degraded amber badge.
|
||||
/// </summary>
|
||||
@@ -199,7 +197,7 @@ public sealed class DashboardBrowseAndAlarmModelTests
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Tests-033: the <c>SinceUtc</c> field must carry the protobuf <c>Since</c>
|
||||
/// The <c>SinceUtc</c> field must carry the protobuf <c>Since</c>
|
||||
/// timestamp converted to a <see cref="DateTimeOffset" />.
|
||||
/// </summary>
|
||||
[Fact]
|
||||
@@ -220,7 +218,7 @@ public sealed class DashboardBrowseAndAlarmModelTests
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Tests-033: <see cref="DashboardAlarmProviderStatus.FromFeed" /> — the entry the
|
||||
/// <see cref="DashboardAlarmProviderStatus.FromFeed" /> — the entry the
|
||||
/// dashboard SignalR snapshot path actually calls — projects a provider-status
|
||||
/// feed message into the badge model.
|
||||
/// </summary>
|
||||
@@ -246,7 +244,7 @@ public sealed class DashboardBrowseAndAlarmModelTests
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Tests-033: <see cref="DashboardAlarmProviderStatus.FromFeed" /> throws
|
||||
/// <see cref="DashboardAlarmProviderStatus.FromFeed" /> throws
|
||||
/// <see cref="ArgumentException" /> when the feed message does not carry a
|
||||
/// provider-status payload.
|
||||
/// </summary>
|
||||
|
||||
Reference in New Issue
Block a user