docs: complete XML doc comments via fixdocs (2757 to 131 findings)

Add missing <returns>/<param>/<summary>/<typeparam> tags and clean up
misused inheritdoc across 481 files so the documented API surface is
complete. Documentation-only (zero code lines changed). The 131 remaining
findings are inheritdoc-style warnings deliberately left to preserve
hand-written implementation rationale (plan-decision notes, race-condition
explanations).

tests/Drivers/ZB.MOM.WW.OtOpcUa.Driver.S7.Tests/S7DiscoveryAndSubscribeTests.cs

@@ -18,31 +18,21 @@ public sealed class S7DiscoveryAndSubscribeTests
         public readonly List<string> Folders = new();
         public readonly List<(string Name, DriverAttributeInfo Attr)> Variables = new();
 
-        /// <summary>Adds a folder to the address space.</summary>
-        /// <param name="browseName">The browse name of the folder.</param>
-        /// <param name="displayName">The display name of the folder.</param>
-        /// <returns>This builder instance for method chaining.</returns>
+        /// <inheritdoc />
         public IAddressSpaceBuilder Folder(string browseName, string displayName)
         {
             Folders.Add(browseName);
             return this;
         }
 
-        /// <summary>Adds a variable to the address space.</summary>
-        /// <param name="browseName">The browse name of the variable.</param>
-        /// <param name="displayName">The display name of the variable.</param>
-        /// <param name="attributeInfo">The attribute information for the variable.</param>
-        /// <returns>A handle to the created variable.</returns>
+        /// <inheritdoc />
         public IVariableHandle Variable(string browseName, string displayName, DriverAttributeInfo attributeInfo)
         {
             Variables.Add((browseName, attributeInfo));
             return new StubHandle();
         }
 
-        /// <summary>Adds a property to a variable.</summary>
-        /// <param name="browseName">The browse name of the property.</param>
-        /// <param name="dataType">The data type of the property.</param>
-        /// <param name="value">The initial value of the property.</param>
+        /// <inheritdoc />
         public void AddProperty(string browseName, DriverDataType dataType, object? value) { }
 
         /// <summary>Attaches an alarm condition to a variable.</summary>
@@ -53,18 +43,17 @@ public sealed class S7DiscoveryAndSubscribeTests
 
         private sealed class StubHandle : IVariableHandle
         {
-            /// <summary>Gets the full reference of the variable.</summary>
+            /// <inheritdoc />
             public string FullReference => "stub";
 
-            /// <summary>Marks this variable as an alarm condition.</summary>
-            /// <param name="info">The alarm condition information.</param>
-            /// <returns>An alarm condition sink.</returns>
+            /// <inheritdoc />
             public IAlarmConditionSink MarkAsAlarmCondition(AlarmConditionInfo info)
                 => throw new NotImplementedException("S7 driver never calls this — no alarm surfacing");
         }
     }
 
     /// <summary>Verifies that DiscoverAsync projects every configured tag into the address space.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task DiscoverAsync_projects_every_tag_into_the_address_space()
     {
@@ -92,6 +81,7 @@ public sealed class S7DiscoveryAndSubscribeTests
     }
 
     /// <summary>Verifies that DiscoverAsync propagates the WriteIdempotent flag from tag configuration to attribute info.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task DiscoverAsync_propagates_WriteIdempotent_from_tag_to_attribute_info()
     {
@@ -127,6 +117,7 @@ public sealed class S7DiscoveryAndSubscribeTests
     }
 
     /// <summary>Verifies that SubscribeAsync returns unique handles and UnsubscribeAsync correctly accepts them.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task SubscribeAsync_returns_unique_handles_and_UnsubscribeAsync_accepts_them()
     {
@@ -151,6 +142,7 @@ public sealed class S7DiscoveryAndSubscribeTests
     }
 
     /// <summary>Verifies that Subscribe floors the publishing interval at 100ms.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task Subscribe_publishing_interval_is_floored_at_100ms()
     {