docs(tests): fix CommentChecker findings across tests/ — 13,392 → 0 (repo-wide scan clean)

Comment/XML-doc changes only:
- add summaries to ~10k test methods, fixtures, fakes and helpers
  (+ <param> on theories, <returns> on async Task methods,
  <inheritdoc/> on interface implementations the checker can resolve)
- strip ~2.6k project-tracking references (WP*, P*-*, row-NN, Task N,
  #NN, Component-0NN) from comments, keeping the explanatory text;
  reword false positives in comments only
- real docs on fakes implementing BCL/library interfaces
  (IDisposable, ILogger, IOptionsMonitor, IAsyncLifetime)
- reword the last 5 src/ false positives (CWE-1236, failures-1,
  year-0001, M365)

Only non-comment edits: four one-line nested classes split across lines
so members can carry docs. Build 0 errors / 0 warnings.
This commit is contained in:
Joseph Doherty
2026-10-07 15:05:49 -04:00
parent 0ffd4bdbea
commit 513fa1aa16
998 changed files with 17896 additions and 2395 deletions
@@ -20,7 +20,7 @@ using DebugViewPage = ZB.MOM.WW.ScadaBridge.CentralUI.Components.Pages.Deploymen
namespace ZB.MOM.WW.ScadaBridge.CentralUI.Tests.Deployment;
/// <summary>
/// DV-5: the Debug View renders a tabbed (Attributes / Alarms) layout, each tab
/// The Debug View renders a tabbed (Attributes / Alarms) layout, each tab
/// hosting a composition <c>TreeView</c>. Computed alarms and attributes nest as
/// leaves under their composition-member branches; native conditions nest under
/// their source-binding node. Branch nodes surface a roll-up (active-count /
@@ -62,7 +62,10 @@ public class DebugViewAlarmTableTests : BunitContext
private sealed class StubAuthStateProvider : AuthenticationStateProvider
{
private readonly AuthenticationState _state;
/// <summary>Initializes the provider with the fixed authentication state to return.</summary>
/// <param name="state">The authentication state returned to every caller.</param>
public StubAuthStateProvider(AuthenticationState state) => _state = state;
/// <inheritdoc />
public override Task<AuthenticationState> GetAuthenticationStateAsync() => Task.FromResult(_state);
}
@@ -98,6 +101,7 @@ public class DebugViewAlarmTableTests : BunitContext
cut.Render();
}
/// <summary>Verifies that both tabs are present, the Attributes tab is the default, and it shows the attribute tree.</summary>
[Fact]
public void BothTabsPresent_AttributesTabIsDefault_AndShowsAttributeTree()
{
@@ -132,6 +136,7 @@ public class DebugViewAlarmTableTests : BunitContext
Assert.NotNull(motor1.QuerySelector("ul[role='group'] li[role='treeitem']"));
}
/// <summary>Verifies that the Alarms tab groups a computed alarm under its branch with an active roll-up badge.</summary>
[Fact]
public void AlarmsTab_GroupsComputedAlarmUnderBranch_WithActiveRollUpBadge()
{
@@ -168,6 +173,7 @@ public class DebugViewAlarmTableTests : BunitContext
Assert.NotNull(highTemp.QuerySelector(".badge.bg-danger")); // Active state badge
}
/// <summary>Verifies that the Alarms tab renders a native condition with enriched badges under its binding node.</summary>
[Fact]
public void AlarmsTab_RendersNativeCondition_WithEnrichedBadgesUnderBindingNode()
{