Documentation modifications

adas-core.Test/Services/SchedulerServiceTest.cs

@@ -16,9 +16,26 @@ using Options = Microsoft.Extensions.Options.Options;
 
 namespace adas_core.Test.Services;
 
+/// <summary>
+/// Contains unit tests that verify the behavior of the <see cref="SchedulerService"/> class.
+/// </summary>
+/// <remarks>
+/// Marked as a test fixture so that the contained test methods are discovered and executed by the test runner.
+/// </remarks>
+/// <!-- aidoc:v1 sig=97a1147 -->
 [TestFixture]
 public class SchedulerServiceTest
 {
+    /// <summary>
+    /// One-time setup that initializes mocked services, lazy wrappers, and test data
+    /// required to exercise <see cref="SchedulerService"/> along with the Quartz-based
+    /// news and expiration jobs (<see cref="CalculateNewsJob"/>, <see cref="CheckExpiredAlertsJob"/>,
+    /// <see cref="CheckExpiredObservationsJob"/>). It configures <see cref="IConfigObservationService"/> and
+    /// <see cref="IObservationService"/> behaviors to match observations by name and patient, and the
+    /// <see cref="IPatientService"/> to return the predefined patient list from
+    /// <see cref="IPatientService.FindInActivePoC"/>, then starts the underlying scheduler.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=518646b body=ec531a6 -->
     [OneTimeSetUp]
     public async Task SetUp()
     {
@@ -267,6 +284,10 @@ public class SchedulerServiceTest
 
 
     //[TearDown]
+    /// <summary>
+    /// Stops the Quartz.NET scheduler engine after all tests in the fixture have run. Uses the null-conditional operator so the call is safely skipped when the scheduler was never initialized.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=3273a4f body=5bdc9c3 -->
     [OneTimeTearDown]
     public void TearDown()
     {