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:
+1
-1
@@ -115,7 +115,7 @@ internal sealed class OpcUaClientBrowseSession : IBrowseSession
|
||||
}
|
||||
catch (OperationCanceledException)
|
||||
{
|
||||
// Caller cancelled mid-pagination (Driver.OpcUaClient.Browser-002): release the
|
||||
// Caller cancelled mid-pagination: release the
|
||||
// server-side cursor on a fresh token (the original is already cancelled).
|
||||
// Best-effort — mirrors OpcUaClientDriver's pagination loop.
|
||||
try
|
||||
|
||||
+4
-6
@@ -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 />
|
||||
|
||||
Reference in New Issue
Block a user