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:
@@ -12,7 +12,7 @@ namespace ZB.MOM.WW.OtOpcUa.Core.Abstractions;
|
||||
/// <i>inbound</i>: a write, an alarm ack, an alerts publish. A Sparkplug primary-host claim is
|
||||
/// not inbound. It is a standing assertion the driver makes to the broker, on its own
|
||||
/// connection, for as long as it holds one — there is no message for the host actor to
|
||||
/// intercept. So the decision has to reach the driver instead (Gitea #511).
|
||||
/// intercept. So the decision has to reach the driver instead.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>The decision, not the role.</b> Same discipline as the alarm-drain view in
|
||||
@@ -61,7 +61,7 @@ public interface IDriverPrimaryRoleSource
|
||||
/// publishing a role there is by definition no peer to collide with, and a closed default
|
||||
/// would make an exclusive-identity claim silently never happen on the single-node deployment
|
||||
/// that is the common case — an inert feature with no error, which is precisely the failure
|
||||
/// mode Gitea #511 was filed about.
|
||||
/// mode this contract exists to prevent.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// The risk this shifts onto the wiring is real and is guarded there instead: a redundant
|
||||
@@ -82,8 +82,7 @@ public sealed class UnmanagedDriverPrimaryRoleSource : IDriverPrimaryRoleSource
|
||||
/// <inheritdoc/>
|
||||
public bool ShouldActAsPrimary => true;
|
||||
|
||||
/// <inheritdoc/>
|
||||
/// <remarks>No-op: there is no redundancy manager to publish anything here.</remarks>
|
||||
/// <inheritdoc />
|
||||
public void PublishPrimaryRole(bool shouldActAsPrimary)
|
||||
{
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user