Documentation modifications

adas-core.Test/Repositories/PumpAlarmEventRepositoryTest.cs

@@ -8,6 +8,13 @@ using MongoDB.Driver;
 
 namespace adas_core.Test.Repositories;
 
+/// <summary>
+/// Provides integration tests for the <see cref="PumpAlarmEventRepository"/>.
+/// </summary>
+/// <remarks>
+/// Marked with the <c>Integration</c> category to allow it to be included or excluded as a group during test execution.
+/// </remarks>
+/// <!-- aidoc:v1 sig=4e55d75 -->
 [TestFixture]
 [Category("Integration")]
 public class PumpAlarmEventRepositoryTest
@@ -161,6 +168,10 @@ public class PumpAlarmEventRepositoryTest
     // -------------------------------------------------------------------
     // FIND LAST BY DEVICE
     // -------------------------------------------------------------------
+    /// <summary>
+    /// Verifies that the repository's <c>FindLastByDeviceIdAsync</c> method returns the most recent event for the specified device by comparing it against the event with the latest <c>Time</c> retrieved via <c>FindByDeviceIdAsync</c>.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=eeea0f1 body=b86e923 -->
     [Test]
     public async Task FindLastByDeviceIdAsync_Works()
     {