docs(xml): fill missing XML doc comments + strip task-tracking refs across src (fixdocs)

Add missing <summary>/<param>/<returns>/<typeparam> tags and switch
interface implementations to <inheritdoc/> across 106 files; strip
project bookkeeping identifiers (Task NN, #05-TNN, PLAN-04, StoreAndForward-0NN)
from shipped code comments while preserving the descriptive rationale.
Comment-only: zero code-logic lines changed; solution builds 0/0.

Claude-Session: https://claude.ai/code/session_01MtdgwpEeCUn6cUA5f1LMPj
This commit is contained in:
Joseph Doherty
2026-07-10 08:23:56 -04:00
parent 75007b9edd
commit 5a878b78d4
106 changed files with 580 additions and 180 deletions
@@ -23,7 +23,7 @@ namespace ZB.MOM.WW.ScadaBridge.StoreAndForward;
/// <item><description>the buffered payload is corrupt (undeserialisable / null) →
/// <see cref="DeliverAsync"/> returns <c>false</c> (the handler contract's
/// permanent-failure signal); the engine parks the row so the payload is preserved
/// for operator forensics. Supersedes StoreAndForward-018's silent discard.</description></item>
/// for operator forensics.</description></item>
/// </list>
///
/// The forward travels over the ClusterClient command/control transport: the handler
@@ -90,8 +90,7 @@ public sealed class NotificationForwarder
PreviewPayload(message.PayloadJson));
// false = permanent failure by the delivery-handler contract → the
// engine parks the row (payload preserved, operator can inspect or
// discard). Supersedes StoreAndForward-018's silent discard, which
// reported the notification as delivered while losing it entirely.
// discard).
return false;
}