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/ZB.MOM.WW.OtOpcUa.Driver.FOCAS/FocasDriverFactoryExtensions.cs

@@ -32,12 +32,19 @@ public static class FocasDriverFactoryExtensions
     ///     Register the FOCAS driver factory in the supplied <see cref="DriverFactoryRegistry"/>.
     ///     Throws if 'FOCAS' is already registered — single-instance per process.
     /// </summary>
+    /// <param name="registry">The driver factory registry to register with.</param>
     public static void Register(DriverFactoryRegistry registry)
     {
         ArgumentNullException.ThrowIfNull(registry);
         registry.Register(DriverTypeName, CreateInstance);
     }
 
+    /// <summary>
+    ///     Creates a new <see cref="FocasDriver"/> instance from the supplied configuration ID and JSON.
+    /// </summary>
+    /// <param name="driverInstanceId">The unique driver instance identifier.</param>
+    /// <param name="driverConfigJson">The driver configuration JSON string.</param>
+    /// <returns>A configured <see cref="FocasDriver"/> instance.</returns>
     internal static FocasDriver CreateInstance(string driverInstanceId, string driverConfigJson)
     {
         ArgumentException.ThrowIfNullOrWhiteSpace(driverInstanceId);
@@ -88,6 +95,12 @@ public static class FocasDriverFactoryExtensions
         return new FocasDriver(options, driverInstanceId, clientFactory);
     }
 
+    /// <summary>
+    ///     Builds the appropriate <see cref="IFocasClientFactory"/> based on the config DTO's backend selection.
+    /// </summary>
+    /// <param name="dto">The driver configuration DTO.</param>
+    /// <param name="driverInstanceId">The driver instance identifier for error reporting.</param>
+    /// <returns>A configured <see cref="IFocasClientFactory"/> instance.</returns>
     internal static IFocasClientFactory BuildClientFactory(
         FocasDriverConfigDto dto, string driverInstanceId)
     {
@@ -183,38 +196,76 @@ public static class FocasDriverFactoryExtensions
 
     internal sealed class FocasDriverConfigDto
     {
+        /// <summary>Gets or sets the FOCAS client factory backend name (e.g. "wire" or "stub").</summary>
         public string? Backend { get; init; }
+
+        /// <summary>Gets or sets the CNC series for this driver.</summary>
         public string? Series { get; init; }
+
+        /// <summary>Gets or sets the operation timeout in milliseconds.</summary>
         public int? TimeoutMs { get; init; }
+
+        /// <summary>Gets or sets the list of CNC devices to manage.</summary>
         public List<FocasDeviceDto>? Devices { get; init; }
+
+        /// <summary>Gets or sets the list of FOCAS tags to poll.</summary>
         public List<FocasTagDto>? Tags { get; init; }
+
+        /// <summary>Gets or sets the probe configuration options.</summary>
         public FocasProbeDto? Probe { get; init; }
+
+        /// <summary>Gets or sets the fixed-tree configuration options.</summary>
         public FocasFixedTreeDto? FixedTree { get; init; }
+
+        /// <summary>Gets or sets the alarm projection configuration options.</summary>
         public FocasAlarmProjectionDto? AlarmProjection { get; init; }
+
+        /// <summary>Gets or sets the handle recycle configuration options.</summary>
         public FocasHandleRecycleDto? HandleRecycle { get; init; }
     }
 
     internal sealed class FocasDeviceDto
     {
+        /// <summary>Gets or sets the hostname or IP address of the CNC.</summary>
         public string? HostAddress { get; init; }
+
+        /// <summary>Gets or sets the logical device name.</summary>
         public string? DeviceName { get; init; }
+
+        /// <summary>Gets or sets the CNC series for this device (overrides top-level series if provided).</summary>
         public string? Series { get; init; }
     }
 
     internal sealed class FocasTagDto
     {
+        /// <summary>Gets or sets the tag name.</summary>
         public string? Name { get; init; }
+
+        /// <summary>Gets or sets the hostname or IP address of the CNC device for this tag.</summary>
         public string? DeviceHostAddress { get; init; }
+
+        /// <summary>Gets or sets the FOCAS address or path for this tag.</summary>
         public string? Address { get; init; }
+
+        /// <summary>Gets or sets the data type for this tag.</summary>
         public string? DataType { get; init; }
+
+        /// <summary>Gets or sets a value indicating whether this tag is writable.</summary>
         public bool? Writable { get; init; }
+
+        /// <summary>Gets or sets a value indicating whether writes to this tag are idempotent.</summary>
         public bool? WriteIdempotent { get; init; }
     }
 
     internal sealed class FocasProbeDto
     {
+        /// <summary>Gets or sets a value indicating whether probing is enabled.</summary>
         public bool? Enabled { get; init; }
+
+        /// <summary>Gets or sets the probe interval in milliseconds.</summary>
         public int? IntervalMs { get; init; }
+
+        /// <summary>Gets or sets the probe timeout in milliseconds.</summary>
         public int? TimeoutMs { get; init; }
     }
 
@@ -225,23 +276,36 @@ public static class FocasDriverFactoryExtensions
     /// </summary>
     internal sealed class FocasFixedTreeDto
     {
+        /// <summary>Gets or sets a value indicating whether fixed-tree discovery is enabled.</summary>
         public bool? Enabled { get; init; }
+
+        /// <summary>Gets or sets the poll interval for discovering fixed-tree items.</summary>
         public TimeSpan? PollInterval { get; init; }
+
+        /// <summary>Gets or sets the poll interval for discovering program-related items.</summary>
         public TimeSpan? ProgramPollInterval { get; init; }
+
+        /// <summary>Gets or sets the poll interval for discovering timer-related items.</summary>
         public TimeSpan? TimerPollInterval { get; init; }
     }
 
     /// <summary>Optional <c>AlarmProjection</c> config section.</summary>
     internal sealed class FocasAlarmProjectionDto
     {
+        /// <summary>Gets or sets a value indicating whether alarm projection is enabled.</summary>
         public bool? Enabled { get; init; }
+
+        /// <summary>Gets or sets the alarm poll interval.</summary>
         public TimeSpan? PollInterval { get; init; }
     }
 
     /// <summary>Optional <c>HandleRecycle</c> config section.</summary>
     internal sealed class FocasHandleRecycleDto
     {
+        /// <summary>Gets or sets a value indicating whether handle recycling is enabled.</summary>
         public bool? Enabled { get; init; }
+
+        /// <summary>Gets or sets the handle recycle interval.</summary>
         public TimeSpan? Interval { get; init; }
     }
 }