Documentation modifications

adas-core.Test/Services/DisplayServiceTest.cs

@@ -15,6 +15,13 @@ using Options = Microsoft.Extensions.Options.Options;
 
 namespace adas_core.Test.Services;
 
+/// <summary>
+/// Provides a NUnit test fixture that exercises the behavior of the DisplayService class.
+/// </summary>
+/// <remarks>
+/// Marked with <see cref="TestFixtureAttribute"/> so the NUnit test runner can discover and execute the contained test methods.
+/// </remarks>
+/// <!-- aidoc:v1 sig=cb14af2 -->
 [TestFixture]
 public class DisplayServiceTest
 {
@@ -144,6 +151,12 @@ public class DisplayServiceTest
     // GetAllByUser - Admin case
     // -----------------------------------------------------------
 
+    /// <summary>
+    /// Verifies that <see cref="DisplayService.GetAllByUser"/> returns all <see cref="Display"/> objects
+    /// associated with the units the user has authorization over when the user holds the
+    /// <see cref="PermissionEnum.RolesType.AuthAdmin"/> role.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=f3916bd body=50fd0aa -->
     [Test]
     public async Task GetAllByUser_ShouldReturnDisplays_WhenAdmin()
     {