docs: fill missing XML docs and strip tracking IDs from src comments

Clears CommentChecker findings in src/ (3,280 -> 209, the remainder being false
positives like PLC-5/IEEE-754/M0.0) by adding missing summaries/params/returns,
normalising inheritdoc usage, and removing Gitea/review tracking IDs while keeping
the rationale they annotated. Comment-only: comment-stripped sources are identical
to the parent commit.
This commit is contained in:
Joseph Doherty
2026-10-15 06:14:58 -04:00
parent ebcbd81fca
commit 826312befe
430 changed files with 4434 additions and 3923 deletions
@@ -42,12 +42,10 @@ public sealed class OpcUaClientDriverBrowser : IDriverBrowser
}
/// <inheritdoc />
/// <remarks>
/// Sourced from the shared <see cref="DriverTypeNames"/> set rather than the hand-written literal
/// this line used to carry (Gitea #558). The value is unchanged; the constant is what
/// <c>DriverTypeNamesGuardTests</c> pins to the factory's own registration, so a rename on either
/// side can no longer leave this browser indexed under a key nothing dispatches to.
/// </remarks>
// Sourced from the shared DriverTypeNames set rather than the hand-written literal
// this line used to carry. The value is unchanged; the constant is what
// DriverTypeNamesGuardTests pins to the factory's own registration, so a rename on either
// side can no longer leave this browser indexed under a key nothing dispatches to.
public string DriverType => DriverTypeNames.OpcUaClient;
/// <inheritdoc />