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
@@ -152,6 +152,9 @@ public class InboundScriptExecutor
public void RemoveHandler(string methodName) => InvalidateMethod(methodName);
/// <summary>Checks compilation without publishing or invalidating a live handler.</summary>
/// <param name="method">The API method whose script is compiled.</param>
/// <param name="errors">The compilation diagnostics, empty on success.</param>
/// <returns><c>true</c> when the script compiles; otherwise <c>false</c>.</returns>
public bool ValidateCompilation(ApiMethod method, out IReadOnlyList<string> errors)
{
var (handler, diagnostics) = Compile(method);
@@ -332,6 +335,7 @@ public class InboundScriptExecutor
/// script execution points back at this inbound request. Null when the script
/// runs outside an inbound API request flow.
/// </param>
/// <param name="trace">When true, the run is traced for the Flow Debugger.</param>
/// <returns>The result of executing the script.</returns>
public async Task<InboundScriptResult> ExecuteAsync(
ApiMethod method,