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
@@ -2,7 +2,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS;
/// <summary>
/// Turns a device-reported sibling-name sequence (axes, spindles) into unique fixed-tree
/// path segments (Gitea #548).
/// path segments.
/// </summary>
/// <remarks>
/// <para>
@@ -27,7 +27,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS;
/// <para>
/// <b>The whole collision set is suffixed, not just the second occurrence.</b> When two
/// axes are both called <c>AA</c>, the bare segment <c>AA</c> ceases to exist — a bare name
/// that silently means "one of the two" is the same silent-wrongness class #534 and #540
/// that silently means "one of the two" is the same silent-wrongness class the earlier selector fixes
/// were about. A tag authored against bare <c>AA</c> on such a machine reads Bad, never one
/// arbitrary axis's data.
/// </para>