Update XML doc comment in backend projects

web/backend/Features/Features.UserManagement/Commands/UpdateUser/UpdateUserHandler.cs

@@ -3,6 +3,9 @@ using MediatR;
 
 namespace Features.UserManagement.Commands.UpdateUser;
 
+/// <summary>
+///     Handles <see cref="UpdateUserCommand" />.
+/// </summary>
 public class UpdateUserHandler(IUserAccountRepository repository)
     : IRequestHandler<UpdateUserCommand>
 {

web/backend/Features/Features.UserManagement/Controllers/UserController.cs

@@ -1,4 +1,5 @@
 using Domain.Entities;
+using Domain.Exceptions;
 using Features.UserManagement.Queries.GetAllUsers;
 using Features.UserManagement.Queries.GetUserById;
 using MediatR;
@@ -6,10 +7,14 @@ using Microsoft.AspNetCore.Mvc;
 
 namespace Features.UserManagement.Controllers;
 
+/// <summary>
+///     Exposes read endpoints for user accounts.
+/// </summary>
 [ApiController]
 [Route("api/[controller]")]
 public class UserController(IMediator mediator) : ControllerBase
 {
+    /// <summary>Gets a page of user accounts, ordered by creation date descending.</summary>
     /// <param name="limit"><c>null</c> for no limit.</param>
     /// <param name="offset"><c>null</c> for no offset.</param>
     [HttpGet]
@@ -22,6 +27,10 @@ public class UserController(IMediator mediator) : ControllerBase
         return Ok(users);
     }
 
+    /// <summary>Gets the user account with the given ID.</summary>
+    /// <exception cref="NotFoundException">
+    /// Thrown when no user account exists with the given ID, resulting in a 404 response.
+    /// </exception>
     [HttpGet("{id:guid}")]
     public async Task<ActionResult<UserAccount>> GetById(Guid id)
     {

web/backend/Features/Features.UserManagement/DependencyInjection/FeaturesUserManagementServiceCollectionExtensions.cs

@@ -3,8 +3,15 @@ using Microsoft.Extensions.DependencyInjection;
 
 namespace Features.UserManagement.DependencyInjection;
 
+/// <summary>
+///     Registers the services used by the Features.UserManagement slice.
+/// </summary>
 public static class FeaturesUserManagementServiceCollectionExtensions
 {
+    /// <summary>
+    ///     Registers <see cref="IUserAccountRepository" /> and its Dapper-based implementation.
+    /// </summary>
+    /// <returns>The same <paramref name="services" /> instance, for chaining.</returns>
     public static IServiceCollection AddFeaturesUserManagement(this IServiceCollection services)
     {
         services.AddScoped<IUserAccountRepository, UserAccountRepository>();

web/backend/Features/Features.UserManagement/Queries/GetAllUsers/GetAllUsersHandler.cs

@@ -4,6 +4,9 @@ using MediatR;
 
 namespace Features.UserManagement.Queries.GetAllUsers;
 
+/// <summary>
+///     Handles <see cref="GetAllUsersQuery" />.
+/// </summary>
 public class GetAllUsersHandler(IUserAccountRepository repository)
     : IRequestHandler<GetAllUsersQuery, IEnumerable<UserAccount>>
 {

web/backend/Features/Features.UserManagement/Queries/GetAllUsers/GetAllUsersQuery.cs

@@ -3,4 +3,9 @@ using MediatR;
 
 namespace Features.UserManagement.Queries.GetAllUsers;
 
+/// <summary>
+///     Requests a page of user accounts, ordered by creation date descending.
+/// </summary>
+/// <param name="Limit"><c>null</c> for no limit.</param>
+/// <param name="Offset"><c>null</c> for no offset.</param>
 public record GetAllUsersQuery(int? Limit, int? Offset) : IRequest<IEnumerable<UserAccount>>;

web/backend/Features/Features.UserManagement/Queries/GetUserById/GetUserByIdHandler.cs

@@ -5,6 +5,9 @@ using MediatR;
 
 namespace Features.UserManagement.Queries.GetUserById;
 
+/// <summary>
+///     Handles <see cref="GetUserByIdQuery" />.
+/// </summary>
 public class GetUserByIdHandler(IUserAccountRepository repository)
     : IRequestHandler<GetUserByIdQuery, UserAccount>
 {

web/backend/Features/Features.UserManagement/Queries/GetUserById/GetUserByIdQuery.cs

@@ -3,4 +3,7 @@ using MediatR;
 
 namespace Features.UserManagement.Queries.GetUserById;
 
+/// <summary>
+///     Requests the user account with the given ID.
+/// </summary>
 public record GetUserByIdQuery(Guid UserAccountId) : IRequest<UserAccount>;

web/backend/Features/Features.UserManagement/Repository/IUserAccountRepository.cs

@@ -1,4 +1,5 @@
 using Domain.Entities;
+using Domain.Exceptions;
 
 namespace Features.UserManagement.Repository;
 
@@ -10,13 +11,18 @@ public interface IUserAccountRepository
     /// <summary>Returns <c>null</c> if no user account exists with the given ID.</summary>
     Task<UserAccount?> GetByIdAsync(Guid id);
 
+    /// <summary>Returns user accounts ordered by creation date descending.</summary>
     /// <param name="limit"><c>null</c> for no limit.</param>
     /// <param name="offset"><c>null</c> for no offset.</param>
     Task<IEnumerable<UserAccount>> GetAllAsync(int? limit, int? offset);
 
+    /// <summary>Updates the mutable fields of an existing user account.</summary>
     /// <param name="userAccount">Must have a valid <c>UserAccountId</c>.</param>
+    /// <exception cref="NotFoundException">Thrown when no user account exists with the given ID.</exception>
     Task UpdateAsync(UserAccount userAccount);
 
+    /// <summary>Deletes the user account with the given ID.</summary>
+    /// <exception cref="NotFoundException">Thrown when no user account exists with the given ID.</exception>
     Task DeleteAsync(Guid id);
 
     /// <summary>Returns <c>null</c> if no user account exists with the given username.</summary>

web/backend/Features/Features.UserManagement/Repository/UserAccountRepository.cs

@@ -46,7 +46,6 @@ public class UserAccountRepository(ISqlConnectionFactory connectionFactory)
     }
 
     /// <inheritdoc />
-    /// <exception cref="NotFoundException">Thrown when no user account exists with the given ID.</exception>
     public async Task UpdateAsync(UserAccount userAccount)
     {
         await using DbConnection connection = await CreateConnection();
@@ -73,7 +72,6 @@ public class UserAccountRepository(ISqlConnectionFactory connectionFactory)
     }
 
     /// <inheritdoc />
-    /// <exception cref="NotFoundException">Thrown when no user account exists with the given <paramref name="id" />.</exception>
     public async Task DeleteAsync(Guid id)
     {
         await using DbConnection connection = await CreateConnection();