docs(xmldoc): fix genuine doc issues surfaced by /fixdocs (17 fixes)

- CapabilityInvoker: 3 methods that implement IDriverCapabilityInvoker now use <inheritdoc /> instead of duplicating the interface docs (MissingInheritDoc). - TwinCAT NativeRegistration ctor: added the 8 missing <param> tags (MissingParam). - Stripped the arch-review bookkeeping IDs STAB-1 (IS7Plc, S7Driver) + STAB-2 (TwinCATDriver x4) from comments, keeping the descriptive text. Left the other 86 flagged items untouched — they are checker false positives on legitimate technical content: interface-implemented events / IEqualityComparer / IDisposable members whose <inheritdoc/> IS correct (10 InheritDocMisused), and domain terms the heuristic misreads as tracking IDs (IEEE-754, S7-1200/300/400/1500, PLC-5, D2-260, S7/Melsec memory addresses, OPC UA Part 9, phase-N design-doc filename refs, UNS level-N descriptions, and prose like 'the #1 bug source' / failover 'pick #3').
2026-07-10 06:23:12 -04:00
parent b67bd9e8b5
commit 3b5ef439d4
4 changed files with 17 additions and 32 deletions
@@ -11,7 +11,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.S7;
 /// <remarks>
 ///     The seam exists so <see cref="S7Driver.EnsureConnectedAsync"/> can dispose a dead handle and
 ///     re-open a fresh one after a transient PLC reboot / network blip — the reconnect path
-///     (STAB-1) — and so that path is unit-testable via a fake <see cref="IS7PlcFactory"/> without a
+///     — and so that path is unit-testable via a fake <see cref="IS7PlcFactory"/> without a
 ///     live PLC (S7.Net ships no in-process fake and <see cref="Plc"/> is <c>sealed</c>). Mirrors
 ///     the TwinCAT driver's <c>ITwinCATClient</c> / <c>ITwinCATClientFactory</c> pattern.
 /// </remarks>