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
@@ -89,6 +89,7 @@ public class SmtpConfigurationPageTests : BunitContext
=> cut.FindAll("select")
.Any(s => s.QuerySelectorAll("option").Any(o => o.TextContent == optionText));
/// <summary>Verifies that the edit form renders the TLS mode select with all three modes.</summary>
[Fact]
public void EditForm_RendersTlsModeSelectWithAllThreeModes()
{
@@ -114,6 +115,7 @@ public class SmtpConfigurationPageTests : BunitContext
});
}
/// <summary>Verifies that the read-only view shows the TLS mode.</summary>
[Fact]
public void ReadOnlyView_ShowsTlsMode()
{
@@ -133,6 +135,7 @@ public class SmtpConfigurationPageTests : BunitContext
});
}
/// <summary>Verifies that saving an edit persists the chosen TLS mode.</summary>
[Fact]
public void SavingEdit_PersistsChosenTlsMode()
{
@@ -168,6 +171,7 @@ public class SmtpConfigurationPageTests : BunitContext
// Transport selector (EWS) — form state machine
// ========================================================================
/// <summary>Verifies that the edit form with the EWS transport hides the port, TLS and auth type and forces basic auth.</summary>
[Fact]
public void EditForm_WithEwsTransport_HidesPortTlsAndAuthTypeAndForcesBasicAuth()
{
@@ -196,6 +200,7 @@ public class SmtpConfigurationPageTests : BunitContext
&& c.Host == "https://mail.example.com/ews/exchange.asmx")));
}
/// <summary>Verifies that switching the transport from EWS back to SMTP restores the auth type and shows the port and TLS fields again.</summary>
[Fact]
public void EditForm_SwitchingEwsBackToSmtp_RestoresAuthTypeAndReshowsPortAndTls()
{
@@ -222,6 +227,7 @@ public class SmtpConfigurationPageTests : BunitContext
&& c.TlsMode == "StartTLS")));
}
/// <summary>Verifies that saving with the EWS transport and a non-HTTPS host shows a form error and does not persist.</summary>
[Fact]
public void Save_WithEwsTransportAndNonHttpsHost_ShowsFormErrorAndDoesNotPersist()
{
@@ -238,6 +244,7 @@ public class SmtpConfigurationPageTests : BunitContext
repo.DidNotReceive().SaveChangesAsync();
}
/// <summary>Verifies that saving with the EWS transport and credentials without a colon shows a form error and does not persist.</summary>
[Fact]
public void Save_WithEwsTransportAndCredentialsWithoutColon_ShowsFormErrorAndDoesNotPersist()
{
@@ -257,6 +264,7 @@ public class SmtpConfigurationPageTests : BunitContext
repo.DidNotReceive().SaveChangesAsync();
}
/// <summary>Verifies that saving with the EWS transport and domain-qualified credentials persists.</summary>
[Fact]
public void Save_WithEwsTransportAndDomainQualifiedCredentials_Persists()
{
@@ -279,6 +287,7 @@ public class SmtpConfigurationPageTests : BunitContext
});
}
/// <summary>Verifies that the read-only view shows the transport badge and hides the port and TLS for EWS rows.</summary>
[Fact]
public void ReadOnlyView_ShowsTransportBadgeAndHidesPortAndTlsForEwsRows()
{
@@ -294,6 +303,7 @@ public class SmtpConfigurationPageTests : BunitContext
});
}
/// <summary>Verifies that a legacy row with a null transport shows the SMTP badge and keeps the port and TLS fields.</summary>
[Fact]
public void ReadOnlyView_LegacyRowWithNullTransport_ShowsSmtpBadgeAndKeepsPortAndTls()
{