Documentation modifications

adas-core.Application/Customizations/HGM/CalculatedObservations.cs

@@ -22,6 +22,12 @@ public class CalculatedObservations : ICalculatedObservations
     private readonly List<string> _nonInvasiveVentilation = [];
     private readonly Lazy<IObservationService> _observationService;
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="CalculatedObservations"/> class by resolving its required dependencies from the supplied <see cref="IServiceProvider"/> and loading the configured high-frequency, invasive, and non-invasive ventilation category lists from <see cref="ApiSettings"/>.
+    /// </summary>
+    /// <param name="serviceProvider">The <see cref="IServiceProvider"/> used to resolve <see cref="IOptions{ApiSettings}"/>, <see cref="ILogger{CalculatedObservations}"/>, and a <see cref="Lazy{IObservationService}"/>.</param>
+    /// <exception cref="InvalidOperationException">Thrown when a required dependency cannot be resolved from <paramref name="serviceProvider"/>.</exception>
+    /// <!-- aidoc:v1 sig=409f903 body=98d5900 -->
     public CalculatedObservations(IServiceProvider serviceProvider)
     {
         var apiSettings = serviceProvider.GetRequiredService<IOptions<ApiSettings>>().Value;

adas-core.Application/Customizations/HUVH/UCIA/CalculatedObservations.cs

@@ -35,6 +35,11 @@ public class CalculatedObservations : ICalculatedObservations
 
     private readonly Lazy<ITreatmentService> _treatmentService;
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="CalculatedObservations"/> class, which provides calculated observations derived from treatment and medicine data, by resolving its required service dependencies and medication reference lists from <paramref name="serviceProvider"/>.
+    /// </summary>
+    /// <param name="serviceProvider">The <see cref="IServiceProvider"/> used to resolve the required service dependencies and configuration options.</param>
+    /// <!-- aidoc:v1 sig=409f903 body=10ae507 -->
     public CalculatedObservations(IServiceProvider serviceProvider)
     {
         _treatmentService = serviceProvider.GetRequiredService<Lazy<ITreatmentService>>();

adas-core.Application/Customizations/HUVH/UCIN/CalculatedObservations.cs

@@ -38,6 +38,12 @@ public class CalculatedObservations : ICalculatedObservations
     private readonly Lazy<ITreatmentService> _treatmentService;
 
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="CalculatedObservations"/> class by resolving its treatment, medicine, observation, logging, and mapping dependencies from the supplied <see cref="IServiceProvider"/>.
+    /// </summary>
+    /// <param name="serviceProvider">The <see cref="IServiceProvider"/> used to obtain the dependencies required by this instance.</param>
+    /// <exception cref="InvalidOperationException">Thrown when a required service cannot be resolved from <paramref name="serviceProvider"/>.</exception>
+    /// <!-- aidoc:v1 sig=409f903 body=5dd8024 -->
     public CalculatedObservations(IServiceProvider serviceProvider)
     {
         _treatmentService = serviceProvider.GetRequiredService<Lazy<ITreatmentService>>();