docs(src): fix CommentChecker findings across src/ — 1,032 → 5 (all false positives)

Comment/XML-doc changes only, no code logic:
- strip project-tracking references (WP*, P*-*, row-NN, #NN, Task N) from
  comments, keeping the explanatory rationale
- add missing summaries, <param>, <returns>, <typeparam> and <inheritdoc/>
- replace misused <inheritdoc/> with real docs; where <inheritdoc/> was
  combined with useful remarks, move the rationale into // comments
- drop stale replicationActor <param> on DeploymentManagerActor ctor

Remaining 5 are false positives (CWE-1236 x2, failures-1, year-0001, M365).
Build 0 errors / 0 warnings.
This commit is contained in:
Joseph Doherty
2026-10-07 14:12:25 -04:00
parent 3a217b9484
commit 0ffd4bdbea
217 changed files with 1224 additions and 695 deletions
@@ -35,7 +35,7 @@ public sealed class ScriptArtifactChangeSubscriber : IHostedService
/// <summary>Initializes the subscriber.</summary>
/// <param name="executor">The compiled-handler cache to invalidate.</param>
/// <param name="methodCache">
/// WP2.6b: the short-TTL resolved-<c>ApiMethod</c>-row cache to invalidate alongside
/// The short-TTL resolved-<c>ApiMethod</c>-row cache to invalidate alongside
/// the compiled handler.
/// </param>
/// <param name="logger">Logger instance.</param>
@@ -52,7 +52,9 @@ public sealed class ScriptArtifactChangeSubscriber : IHostedService
_bus = bus;
}
/// <inheritdoc />
/// <summary>Subscribes to the change bus, when one is registered, to invalidate cached handlers.</summary>
/// <param name="cancellationToken">Cancellation token (unused).</param>
/// <returns>A completed task.</returns>
public Task StartAsync(CancellationToken cancellationToken)
{
if (_bus is null)
@@ -66,7 +68,9 @@ public sealed class ScriptArtifactChangeSubscriber : IHostedService
return Task.CompletedTask;
}
/// <inheritdoc />
/// <summary>Disposes the change-bus subscription.</summary>
/// <param name="cancellationToken">Cancellation token (unused).</param>
/// <returns>A completed task.</returns>
public Task StopAsync(CancellationToken cancellationToken)
{
_subscription?.Dispose();