Documentation modifications

adas-core.Test/Repositories/MongodbMigrationTest.cs

@@ -12,6 +12,13 @@ using Options = Microsoft.Extensions.Options.Options;
 
 namespace adas_core.Test.Repositories;
 
+/// <summary>
+/// Integration test fixture that verifies MongoDB migration behavior.
+/// </summary>
+/// <remarks>
+/// Marked with <see cref="TestFixtureAttribute"/> and <see cref="CategoryAttribute"/> using the "Integration" category to group it with other integration-level tests.
+/// </remarks>
+/// <!-- aidoc:v1 sig=c113d9c -->
 [TestFixture]
 [Category("Integration")]
 public class MongodbMigrationTest
@@ -131,6 +138,10 @@ public class MongodbMigrationTest
             Assert.That(ids, Does.Contain(10)); // 0.1.0
         }
 
+    /// <summary>
+    /// Verifies that running migrations twice via the runner is idempotent and does not fail, and that the migration identified by id 10 remains present in the applied set returned by <c>GetAppliedMigrationIds</c> after the second <c>UpdateToLatest</c> execution.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=e6dd929 body=b78ac59 -->
     [Test]
     public void RunningMigrationsTwice_ShouldNotFail()
     {