new documentation changes

OmegaLeo.HelperLib.Game/Extensions/ListExtensions.cs

@@ -1,10 +1,21 @@
 using System.Collections.Generic;
+using NetFlow.DocumentationHelper.Library.Attributes;
 using OmegaLeo.HelperLib.Game.Models;
 
 namespace OmegaLeo.HelperLib.Game.Extensions
 {
     public static class ListExtensions
     {
+        [Documentation(nameof(Shuffle), 
+            "Shuffles the elements of the list in place using the provided RandomNumberGenerator.", 
+            null, 
+            @"```csharp
+var list = new List<int> { 1, 2, 3, 4};
+var rng = new RandomNumberGenerator();
+// List before: [1, 2, 3, 4]
+list.Shuffle(rng);
+// List after: [3, 1, 4, 2] (example output)
+```")]
         public static void Shuffle<T>(this IList<T> list, RandomNumberGenerator rng)
         {
             for (int i = list.Count - 1; i > 0; i--)

OmegaLeo.HelperLib.Game/Handlers/DelayedActionHandler.cs

@@ -1,7 +1,12 @@
+using NetFlow.DocumentationHelper.Library.Attributes;
 using OmegaLeo.HelperLib.Game.Models;
 
 namespace OmegaLeo.HelperLib.Game.Handlers
 {
+    [Documentation(nameof(DelayedActionHandler), "Handler for managing delayed actions, allowing cancellation and status checking.", null, @"```csharp
+var action = new DelayedAction(...);
+var handler = new DelayedActionHandler(action);
+```")]
     public class DelayedActionHandler
     {
         private readonly DelayedAction _action;
@@ -11,6 +16,9 @@ namespace OmegaLeo.HelperLib.Game.Handlers
             _action = action;
         }
 
+        [Documentation(nameof(Cancel), "Cancels the delayed action if it has not yet executed.", null, @"```csharp
+handler.Cancel();
+```")]
         public void Cancel()
         {
             if (_action != null)