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:
@@ -763,7 +763,7 @@ public static class AuditEndpoints
|
||||
|
||||
// ─────────────────────────────────────────────────────────────────────
|
||||
// CSV helpers — 24 columns, same order/naming as the JSONL export
|
||||
// (AuditExportRow property declaration order; arch-review 2026-08-19 P6-7)
|
||||
// (AuditExportRow property declaration order)
|
||||
// ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
public const string CsvHeader =
|
||||
@@ -783,7 +783,7 @@ public static class AuditEndpoints
|
||||
/// <see cref="AuditExportRow.ResponseSummary"/>, <see cref="AuditExportRow.Extra"/>) are run
|
||||
/// through <see cref="NeedsFormulaNeutralization"/> before RFC 4180 quoting so a leading
|
||||
/// <c>=</c>/<c>+</c>/<c>-</c>/<c>@</c>/TAB/CR can't be interpreted as a formula or DDE
|
||||
/// trigger by a spreadsheet application (CWE-1236). GUID/enum/numeric/date/bool columns the
|
||||
/// trigger by a spreadsheet application (CSV formula injection). GUID/enum/numeric/date/bool columns the
|
||||
/// exporter formats itself are never neutralized — none of them can start with a trigger
|
||||
/// character, and neutralizing a signed numeric column would corrupt it.
|
||||
/// </summary>
|
||||
@@ -833,7 +833,7 @@ public static class AuditEndpoints
|
||||
return;
|
||||
}
|
||||
|
||||
// OWASP CSV-injection neutralization (CWE-1236): a free-text cell whose
|
||||
// OWASP CSV-injection neutralization (CSV formula injection): a free-text cell whose
|
||||
// first character would be interpreted by a spreadsheet application as a
|
||||
// formula/DDE trigger is prefixed with a literal single quote. Applied
|
||||
// BEFORE RFC 4180 quoting, and only to free-text columns — never to the
|
||||
|
||||
Reference in New Issue
Block a user