docs(xmldoc): fill missing XML docs + strip tracking-ID comments across src

Adds <summary>/<param>/<returns>/<inheritdoc> where missing and removes
project bookkeeping IDs (task/tracking refs) from shipped code comments,
so the docs read cleanly and CommentChecker is quiet except for known
false positives (PLC/protocol terms, event/IEqualityComparer inheritdoc).
Doc/comment-only; no logic changed; solution builds clean.

src/Client/ZB.MOM.WW.OtOpcUa.Client.UI/Services/AvaloniaUiDispatcher.cs

@@ -7,8 +7,7 @@ namespace ZB.MOM.WW.OtOpcUa.Client.UI.Services;
 /// </summary>
 public sealed class AvaloniaUiDispatcher : IUiDispatcher
 {
-    /// <summary>Posts an action to the Avalonia UI thread for execution.</summary>
-    /// <param name="action">The action to execute on the UI thread.</param>
+    /// <inheritdoc />
     public void Post(Action action)
     {
         Dispatcher.UIThread.Post(action);

src/Client/ZB.MOM.WW.OtOpcUa.Client.UI/Services/ISettingsService.cs

@@ -6,6 +6,7 @@ namespace ZB.MOM.WW.OtOpcUa.Client.UI.Services;
 public interface ISettingsService
 {
     /// <summary>Loads user settings from persistent storage.</summary>
+    /// <returns>The loaded user settings.</returns>
     UserSettings Load();
     /// <summary>Saves user settings to persistent storage.</summary>
     /// <param name="settings">The settings to save.</param>

src/Client/ZB.MOM.WW.OtOpcUa.Client.UI/Services/JsonSettingsService.cs

@@ -8,7 +8,7 @@ namespace ZB.MOM.WW.OtOpcUa.Client.UI.Services;
 /// </summary>
 public sealed class JsonSettingsService : ISettingsService
 {
-    // ClientStoragePaths.GetRoot runs the one-shot legacy-folder migration so pre-#208
+    // ClientStoragePaths.GetRoot runs the one-shot legacy-folder migration so pre-rename
     // developer boxes pick up their existing settings.json on first launch post-rename.
     private static readonly string SettingsDir = ClientStoragePaths.GetRoot();
 
@@ -19,8 +19,8 @@ public sealed class JsonSettingsService : ISettingsService
         WriteIndented = true
     };
 
-    /// <summary>Loads user settings from the settings file.</summary>
-    /// <returns>The loaded user settings, or a new default instance if load fails.</returns>
+    /// <inheritdoc />
+    // Returns a new default instance when the settings file is missing or fails to load/parse.
     public UserSettings Load()
     {
         try
@@ -37,8 +37,7 @@ public sealed class JsonSettingsService : ISettingsService
         }
     }
 
-    /// <summary>Saves user settings to the settings file.</summary>
-    /// <param name="settings">The user settings to save.</param>
+    /// <inheritdoc />
     public void Save(UserSettings settings)
     {
         try

src/Client/ZB.MOM.WW.OtOpcUa.Client.UI/Services/SynchronousUiDispatcher.cs

@@ -6,8 +6,7 @@ namespace ZB.MOM.WW.OtOpcUa.Client.UI.Services;
 /// </summary>
 public sealed class SynchronousUiDispatcher : IUiDispatcher
 {
-    /// <summary>Executes the action synchronously on the calling thread.</summary>
-    /// <param name="action">The action to execute.</param>
+    /// <inheritdoc />
     public void Post(Action action)
     {
         action();

src/Client/ZB.MOM.WW.OtOpcUa.Client.UI/ViewModels/AlarmsViewModel.cs

@@ -256,6 +256,7 @@ public partial class AlarmsViewModel : ObservableObject
     /// <summary>
     ///     Returns the monitored node ID for persistence, or null if not subscribed.
     /// </summary>
+    /// <returns>The monitored node ID, or null if not subscribed.</returns>
     public string? GetAlarmSourceNodeId()
     {
         return IsSubscribed ? MonitoredNodeIdText : null;

src/Client/ZB.MOM.WW.OtOpcUa.Client.UI/ViewModels/BrowseTreeViewModel.cs

@@ -30,6 +30,7 @@ public class BrowseTreeViewModel : ObservableObject
     /// <summary>
     ///     Loads root nodes by browsing with a null parent.
     /// </summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     public async Task LoadRootsAsync()
     {
         var results = await _service.BrowseAsync();

src/Client/ZB.MOM.WW.OtOpcUa.Client.UI/ViewModels/SubscriptionsViewModel.cs

@@ -143,6 +143,7 @@ public partial class SubscriptionsViewModel : ObservableObject
     /// </summary>
     /// <param name="nodeIdStr">The node ID to subscribe to from the browse tree or persisted settings.</param>
     /// <param name="intervalMs">The monitored-item interval, in milliseconds, for the subscription.</param>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     public async Task AddSubscriptionForNodeAsync(string nodeIdStr, int intervalMs = 1000)
     {
         if (!IsConnected || string.IsNullOrWhiteSpace(nodeIdStr)) return;
@@ -176,6 +177,7 @@ public partial class SubscriptionsViewModel : ObservableObject
     /// <param name="nodeIdStr">The root node whose variables should be subscribed recursively.</param>
     /// <param name="nodeClass">The node class of the starting node so variables can be subscribed immediately.</param>
     /// <param name="intervalMs">The monitored-item interval, in milliseconds, used for created subscriptions.</param>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     public Task AddSubscriptionRecursiveAsync(string nodeIdStr, string nodeClass, int intervalMs = 1000)
     {
         return AddSubscriptionRecursiveAsync(nodeIdStr, nodeClass, intervalMs, maxDepth: 10, currentDepth: 0);
@@ -211,6 +213,7 @@ public partial class SubscriptionsViewModel : ObservableObject
     /// <summary>
     ///     Returns the node IDs of all active subscriptions for persistence.
     /// </summary>
+    /// <returns>The node IDs of all currently active subscriptions.</returns>
     public List<string> GetSubscribedNodeIds()
     {
         return ActiveSubscriptions.Select(s => s.NodeId).ToList();
@@ -220,6 +223,7 @@ public partial class SubscriptionsViewModel : ObservableObject
     ///     Restores subscriptions from a saved list of node IDs.
     /// </summary>
     /// <param name="nodeIds">The node IDs persisted from a prior UI session.</param>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     public async Task RestoreSubscriptionsAsync(IEnumerable<string> nodeIds)
     {
         foreach (var nodeId in nodeIds)
@@ -232,6 +236,7 @@ public partial class SubscriptionsViewModel : ObservableObject
     /// </summary>
     /// <param name="nodeIdStr">The node ID the operator wants to write.</param>
     /// <param name="rawValue">The raw text value entered by the operator.</param>
+    /// <returns>A tuple indicating whether the write succeeded and a human-readable status message.</returns>
     public async Task<(bool Success, string Message)> ValidateAndWriteAsync(string nodeIdStr, string rawValue)
     {
         try

src/Client/ZB.MOM.WW.OtOpcUa.Client.UI/Views/ShelveAlarmWindow.axaml.cs

@@ -20,6 +20,8 @@ public partial class ShelveAlarmWindow : Window
     }
 
     /// <summary>Creates the shelve dialog for an alarm.</summary>
+    /// <param name="alarmsVm">The view model used to issue the shelve/unshelve command.</param>
+    /// <param name="alarm">The alarm event being shelved.</param>
     public ShelveAlarmWindow(AlarmsViewModel alarmsVm, AlarmEventViewModel alarm)
     {
         InitializeComponent();