docs: backfill XML documentation across 756 files

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.

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/Commands/ProbeCommand.cs

@@ -14,13 +14,16 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli.Commands;
 [Command("probe", Description = "Verify the CNC is reachable + a sample FOCAS read succeeds.")]
 public sealed class ProbeCommand : FocasCommandBase
 {
+    /// <summary>Gets the FOCAS address to probe.</summary>
     [CommandOption("address", 'a', Description =
         "FOCAS address to probe (default R100 — PMC R-file register 100).")]
     public string Address { get; init; } = "R100";
 
+    /// <summary>Gets the data type to use for the probe read.</summary>
     [CommandOption("type", Description = "Data type (default Int16).")]
     public FocasDataType DataType { get; init; } = FocasDataType.Int16;
 
+    /// <inheritdoc />
     public override async ValueTask ExecuteAsync(IConsole console)
     {
         ConfigureLogging();

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/Commands/ReadCommand.cs

@@ -10,16 +10,20 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli.Commands;
 [Command("read", Description = "Read a single FOCAS address.")]
 public sealed class ReadCommand : FocasCommandBase
 {
+    /// <summary>Gets the FOCAS address to read.</summary>
     [CommandOption("address", 'a', Description =
         "FOCAS address. Examples: R100 (PMC R-file word); X0.0 (PMC X-bit); " +
         "PARAM:1815/0 (parameter 1815, axis 0); MACRO:500 (macro variable 500).",
         IsRequired = true)]
     public string Address { get; init; } = default!;
 
+    /// <summary>Gets the data type to interpret the address as.</summary>
     [CommandOption("type", 't', Description =
         "Bit / Byte / Int16 / Int32 / Float32 / Float64 / String (default Int16).")]
     public FocasDataType DataType { get; init; } = FocasDataType.Int16;
 
+    /// <summary>Executes the read command against the FOCAS device.</summary>
+    /// <inheritdoc />
     public override async ValueTask ExecuteAsync(IConsole console)
     {
         ConfigureLogging();
@@ -45,6 +49,9 @@ public sealed class ReadCommand : FocasCommandBase
         await console.Output.WriteLineAsync(SnapshotFormatter.Format(Address, snapshot[0]));
     }
 
+    /// <summary>Constructs a tag name from address and data type.</summary>
+    /// <param name="address">The FOCAS address.</param>
+    /// <param name="type">The data type.</param>
     internal static string SynthesiseTagName(string address, FocasDataType type)
         => $"{address}:{type}";
 }

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/Commands/SubscribeCommand.cs

@@ -12,16 +12,20 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli.Commands;
 [Command("subscribe", Description = "Watch a FOCAS address via polled subscription until Ctrl+C.")]
 public sealed class SubscribeCommand : FocasCommandBase
 {
+    /// <summary>Gets the FOCAS address to subscribe to.</summary>
     [CommandOption("address", 'a', Description = "FOCAS address — same format as `read`.", IsRequired = true)]
     public string Address { get; init; } = default!;
 
+    /// <summary>Gets the data type of the address.</summary>
     [CommandOption("type", 't', Description =
         "Bit / Byte / Int16 / Int32 / Float32 / Float64 / String (default Int16).")]
     public FocasDataType DataType { get; init; } = FocasDataType.Int16;
 
+    /// <summary>Gets the polling interval in milliseconds.</summary>
     [CommandOption("interval-ms", 'i', Description = "Publishing interval ms (default 1000).")]
     public int IntervalMs { get; init; } = 1000;
 
+    /// <inheritdoc />
     public override async ValueTask ExecuteAsync(IConsole console)
     {
         ConfigureLogging();

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/Commands/WriteCommand.cs

@@ -14,18 +14,22 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli.Commands;
 [Command("write", Description = "Write a single FOCAS address.")]
 public sealed class WriteCommand : FocasCommandBase
 {
+    /// <summary>Gets the FOCAS address to write to.</summary>
     [CommandOption("address", 'a', Description = "FOCAS address — same format as `read`.", IsRequired = true)]
     public string Address { get; init; } = default!;
 
+    /// <summary>Gets the data type of the value to write.</summary>
     [CommandOption("type", 't', Description =
         "Bit / Byte / Int16 / Int32 / Float32 / Float64 / String (default Int16).")]
     public FocasDataType DataType { get; init; } = FocasDataType.Int16;
 
+    /// <summary>Gets the value to write.</summary>
     [CommandOption("value", 'v', Description =
         "Value to write. Parsed per --type (booleans accept true/false/1/0).",
         IsRequired = true)]
     public string Value { get; init; } = default!;
 
+    /// <inheritdoc />
     public override async ValueTask ExecuteAsync(IConsole console)
     {
         ConfigureLogging();
@@ -62,6 +66,9 @@ public sealed class WriteCommand : FocasCommandBase
     ///     as a clean <see cref="CliFx.Exceptions.CommandException"/> rather than a raw
     ///     .NET stack trace — matching the friendly message the Bit path already produces.
     /// </remarks>
+    /// <param name="raw">The raw string value to parse.</param>
+    /// <param name="type">The data type to parse the value as.</param>
+    /// <returns>The parsed value as an object.</returns>
     internal static object ParseValue(string raw, FocasDataType type)
     {
         if (type == FocasDataType.Bit) return ParseBool(raw);

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/FocasCommandBase.cs

@@ -10,19 +10,23 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli;
 /// </summary>
 public abstract class FocasCommandBase : DriverCommandBase
 {
+    /// <summary>Gets the CNC IP address or hostname.</summary>
     [CommandOption("cnc-host", 'h', Description =
         "CNC IP address or hostname. FOCAS-over-EIP listens on port 8193 by default.",
         IsRequired = true)]
     public string CncHost { get; init; } = default!;
 
+    /// <summary>Gets the FOCAS TCP port.</summary>
     [CommandOption("cnc-port", 'p', Description = "FOCAS TCP port (default 8193).")]
     public int CncPort { get; init; } = 8193;
 
+    /// <summary>Gets the CNC series.</summary>
     [CommandOption("series", 's', Description =
         "CNC series: Unknown / Zero_i_D / Zero_i_F / Zero_i_MF / Zero_i_TF / Sixteen_i / " +
         "Thirty_i / ThirtyOne_i / ThirtyTwo_i / PowerMotion_i (default Unknown).")]
     public FocasCncSeries Series { get; init; } = FocasCncSeries.Unknown;
 
+    /// <summary>Gets the per-operation timeout in milliseconds.</summary>
     [CommandOption("timeout-ms", Description = "Per-operation timeout in ms (default 2000).")]
     public int TimeoutMs { get; init; } = 2000;
 
@@ -42,6 +46,7 @@ public abstract class FocasCommandBase : DriverCommandBase
     ///     wire client opens a TCP:8193 session to the CNC and surfaces unreachable endpoints
     ///     as <c>BadCommunicationError</c>.
     /// </summary>
+    /// <param name="tags">The tag definitions to include in the driver options.</param>
     protected FocasDriverOptions BuildOptions(IReadOnlyList<FocasTagDefinition> tags) => new()
     {
         Devices = [new FocasDeviceOptions(
@@ -53,6 +58,7 @@ public abstract class FocasCommandBase : DriverCommandBase
         Probe = new FocasProbeOptions { Enabled = false },
     };
 
+    /// <summary>Gets the driver instance ID.</summary>
     protected string DriverInstanceId => $"focas-cli-{CncHost}:{CncPort}";
 
     /// <summary>
@@ -64,6 +70,7 @@ public abstract class FocasCommandBase : DriverCommandBase
     ///     option is subscribe-only — pass <c>null</c> for probe/read/write so this
     ///     helper can be a single shared validator.
     /// </summary>
+    /// <param name="intervalMs">The interval in milliseconds, or null if not applicable.</param>
     protected void ValidateOptions(int? intervalMs = null)
     {
         if (CncPort < 1 || CncPort > 65535)