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:
@@ -36,8 +36,7 @@ public static class OutputFormatter
|
||||
/// <summary>
|
||||
/// One row for the <see cref="TableRow"/> overload of <c>WriteTable</c>: either padded
|
||||
/// column cells like the plain <see cref="string[]"/> overload, or an already-formatted
|
||||
/// line printed verbatim with no column padding/alignment at all (Task 14 review,
|
||||
/// 2026-09-09) — used for a note/log line folded onto a step, which must render as a raw
|
||||
/// line printed verbatim with no column padding/alignment at all — used for a note/log line folded onto a step, which must render as a raw
|
||||
/// indented line under that step's row rather than as a cell in a table column (every
|
||||
/// other row's cell there would otherwise render blank, and the line's own leading
|
||||
/// whitespace would be swallowed by column padding).
|
||||
@@ -50,14 +49,20 @@ public static class OutputFormatter
|
||||
RawLine = rawLine;
|
||||
}
|
||||
|
||||
/// <summary>The column cells of a normal row, or null for a raw line.</summary>
|
||||
internal string[]? Cells { get; }
|
||||
|
||||
/// <summary>The verbatim line of a raw row, or null for a column row.</summary>
|
||||
internal string? RawLine { get; }
|
||||
|
||||
/// <summary>A normal row, rendered as padded columns aligned with the header set.</summary>
|
||||
/// <param name="cells">The column cell values.</param>
|
||||
/// <returns>A column row.</returns>
|
||||
internal static TableRow Columns(string[] cells) => new(cells, null);
|
||||
|
||||
/// <summary>An already-formatted line, printed exactly as given with no column alignment.</summary>
|
||||
/// <param name="line">The preformatted line.</param>
|
||||
/// <returns>A raw row.</returns>
|
||||
internal static TableRow Raw(string line) => new(null, line);
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user