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
@@ -590,16 +590,27 @@ public class DeploymentManagerRepository : IDeploymentManagerRepository
/// </summary>
private sealed class DeploymentInstanceJoin
{
/// <summary>Deployment record primary key.</summary>
public int Id { get; init; }
/// <summary>Unique deployment identifier.</summary>
public string DeploymentId { get; init; } = string.Empty;
/// <summary>Primary key of the target instance.</summary>
public int InstanceId { get; init; }
/// <summary>Unique name of the target instance.</summary>
public string InstanceUniqueName { get; init; } = string.Empty;
/// <summary>Primary key of the instance's site.</summary>
public int SiteId { get; init; }
/// <summary>Current deployment status.</summary>
public DeploymentStatus Status { get; init; }
/// <summary>Revision hash of the deployed configuration, if any.</summary>
public string? RevisionHash { get; init; }
/// <summary>User who initiated the deployment.</summary>
public string DeployedBy { get; init; } = string.Empty;
/// <summary>When the deployment was initiated.</summary>
public DateTimeOffset DeployedAt { get; init; }
/// <summary>When the deployment completed, if it has.</summary>
public DateTimeOffset? CompletedAt { get; init; }
/// <summary>Failure message, if the deployment failed.</summary>
public string? ErrorMessage { get; init; }
}
}