docs: backfill XML documentation across 756 files
v2-ci / build (push) Failing after 1m43s
v2-ci / unit-tests (tests/Core/ZB.MOM.WW.OtOpcUa.Cluster.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.ControlPlane.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Security.Tests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.Host.IntegrationTests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.IntegrationTests) (push) Has been skipped
v2-ci / build (push) Failing after 1m43s
v2-ci / unit-tests (tests/Core/ZB.MOM.WW.OtOpcUa.Cluster.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.ControlPlane.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Security.Tests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.Host.IntegrationTests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.IntegrationTests) (push) Has been skipped
Adds <summary>, <param>, <typeparam>, and <inheritdoc/> tags to public members surfaced by commentchecker — resolves 5,847 of 5,869 issues (99.6%) across three /fixdocs passes.
This commit is contained in:
+13
@@ -22,14 +22,20 @@ public sealed class FocasCommandBaseValidationTests
|
||||
[Command("noop-test", Description = "Test-only probe of FocasCommandBase.ValidateOptions.")]
|
||||
private sealed class Probe : FocasCommandBase
|
||||
{
|
||||
/// <summary>Gets or sets the interval in milliseconds.</summary>
|
||||
public int IntervalMs { get; init; }
|
||||
|
||||
/// <inheritdoc />
|
||||
public override ValueTask ExecuteAsync(IConsole console) => default;
|
||||
|
||||
/// <summary>Invokes option validation with interval.</summary>
|
||||
public void InvokeValidate() => ValidateOptions(IntervalMs);
|
||||
|
||||
/// <summary>Invokes option validation without interval.</summary>
|
||||
public void InvokeValidateNoInterval() => ValidateOptions(intervalMs: null);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that default options are accepted.</summary>
|
||||
[Fact]
|
||||
public void Validate_accepts_default_options()
|
||||
{
|
||||
@@ -37,6 +43,8 @@ public sealed class FocasCommandBaseValidationTests
|
||||
Should.NotThrow(() => sut.InvokeValidate());
|
||||
}
|
||||
|
||||
/// <summary>Verifies that out-of-range CNC port is rejected.</summary>
|
||||
/// <param name="port">The port value to test.</param>
|
||||
[Theory]
|
||||
[InlineData(0)]
|
||||
[InlineData(-1)]
|
||||
@@ -48,6 +56,8 @@ public sealed class FocasCommandBaseValidationTests
|
||||
ex.Message.ShouldContain("cnc-port", Case.Insensitive);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that non-positive timeout is rejected.</summary>
|
||||
/// <param name="timeoutMs">The timeout value in milliseconds to test.</param>
|
||||
[Theory]
|
||||
[InlineData(0)]
|
||||
[InlineData(-100)]
|
||||
@@ -58,6 +68,8 @@ public sealed class FocasCommandBaseValidationTests
|
||||
ex.Message.ShouldContain("timeout-ms", Case.Insensitive);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that non-positive interval is rejected.</summary>
|
||||
/// <param name="intervalMs">The interval value in milliseconds to test.</param>
|
||||
[Theory]
|
||||
[InlineData(0)]
|
||||
[InlineData(-500)]
|
||||
@@ -68,6 +80,7 @@ public sealed class FocasCommandBaseValidationTests
|
||||
ex.Message.ShouldContain("interval-ms", Case.Insensitive);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that interval check is skipped when command omits it.</summary>
|
||||
[Fact]
|
||||
public void Validate_skips_interval_check_when_command_omits_it()
|
||||
{
|
||||
|
||||
Reference in New Issue
Block a user