Documentation modifications

adas-core.Test/Services/NoCacheServiceTest.cs

@@ -2,6 +2,10 @@ using adas_core.Application.Services.Caching;
 
 namespace adas_core.Test.Services;
 
+/// <summary>
+/// Test fixture that validates the behavior of the NoCacheService, ensuring its operations function correctly in a non-caching context.
+/// </summary>
+/// <!-- aidoc:v1 sig=d79267a -->
 [TestFixture]
 public class NoCacheServiceTest
 {
@@ -19,6 +23,11 @@ public class NoCacheServiceTest
 
     #region TC-27
 
+    /// <summary>
+    /// Verifies that the no-cache implementation of <see cref="GetOrSetObjectAsync"/> always invokes the supplied factory delegate
+    /// and never returns a previously cached value, even when called repeatedly with the same key.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=0ade665 body=93b4d4c -->
     [Test]
     public async Task GetOrSetObjectAsync_AlwaysCallsFactory_NeverUsesCache()
     {
@@ -45,6 +54,10 @@ public class NoCacheServiceTest
         Assert.That(result2, Is.EqualTo(expectedResult));
     }
 
+    /// <summary>
+    /// Verifies that <c>GetOrSetValueAsync</c> invokes the supplied factory delegate once for every unique key passed in, ensuring that the no-cache implementation does not deduplicate or short-circuit calls based on key uniqueness.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=7b6a45d body=15c5c5c -->
     [Test]
     public async Task GetOrSetObjectAsync_CallsFactory_ForEachUniqueKey()
     {