Documentation modifications

adas-core.Domain/Models/AppSettings/AuthSettings.cs

@@ -70,6 +70,10 @@ public class UsersWhiteListConfig : List<string>
 /// <remarks>
 /// This type serves as a container or marker for grouping validation logic within a broader validation framework.
 /// </remarks>
+/// <summary>
+/// Represents a group that has been validated as meeting the required criteria.
+/// </summary>
+/// <!-- aidoc:v1 sig=1cee181 -->
 public class ValidGroupsConfig : List<ValidGroup>
 {
     /// <summary>

adas-core.Domain/Models/AppSettings/PermissionSettings.cs

@@ -272,6 +272,13 @@ public class PermissionSettings
     );
 }
 
+/// <summary>
+/// Represents a set of permissions for a source, grouping the unit-level and display-level <see cref="DisplayPermissionTypes"/> together with the corresponding <see cref="PanelPermissionTypes"/>.
+/// </summary>
+/// <remarks>
+/// The primary constructor captures <paramref name="unit"/> and <paramref name="display"/> permissions as <see cref="DisplayPermissionTypes"/>, and <paramref name="panel"/> permissions as <see cref="PanelPermissionTypes"/>.
+/// </remarks>
+/// <!-- aidoc:v1 sig=74dcf70 -->
 public class SourcePermissions(
     DisplayPermissionTypes unit,
     DisplayPermissionTypes display,
@@ -282,6 +289,13 @@ public class SourcePermissions(
     public PanelPermissionTypes Panel { get; set; } = panel;
 }
 
+/// <summary>
+/// Encapsulates a collection of <see cref="UserActions"/> that govern the display permissions for clinical and administrative areas such as admissions, discharges, observations, demographic data, box blocking, notices, and cell management.
+/// </summary>
+/// <remarks>
+/// The <paramref name="useDemoMode"/> flag indicates whether the permission configuration should be evaluated in demonstration mode.
+/// </remarks>
+/// <!-- aidoc:v1 sig=5c32eb7 -->
 public class DisplayPermissionTypes(
     UserActions admissions,
     UserActions discharges,
@@ -302,6 +316,13 @@ public class DisplayPermissionTypes(
     public bool UseDemoMode { get; set; } = useDemoMode;
 }
 
+/// <summary>
+/// Encapsulates the <see cref="UserActions"/> permissions available for each application panel, such as <paramref name="units"/>, <paramref name="patients"/>, and <paramref name="observations"/>, along with the <paramref name="useDemoMode"/> flag.
+/// </summary>
+/// <remarks>
+/// A dedicated <see cref="UserActions"/> value is supplied for every panel — units, displays, display configurations, master lists, treatments, patients, medicines, pumps, users, configuration observations, observations, and audits — so that the access rights for each section can be evaluated independently. The <paramref name="useDemoMode"/> parameter indicates whether the system is operating in demo mode.
+/// </remarks>
+/// <!-- aidoc:v1 sig=3d15620 -->
 public class PanelPermissionTypes(
     UserActions units,
     UserActions displays,

adas-core.Domain/Models/DTO/UnitInfoDto.cs

@@ -9,11 +9,21 @@ namespace adas_core.Domain.Models.DTO;
 /// </summary>
 public class UnitInfoDto
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="UnitInfoDto"/> data transfer object, enabling JSON deserialization via the <see cref="JsonConstructorAttribute"/>.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=e9065d4 body=4448e1d -->
     [JsonConstructor]
     public UnitInfoDto()
     {
     }
 
+    /// <summary>
+    /// Initializes a new instance of <see cref="UnitInfoDto"/> from the supplied <paramref name="unit"/>,
+    /// projecting its identifier and name into the DTO with safe empty-string defaults for the display fields.
+    /// </summary>
+    /// <param name="unit">The optional <see cref="Unit"/> whose values populate the DTO; when null, the string properties default to <see cref="string.Empty"/>.</param>
+    /// <!-- aidoc:v1 sig=98aa992 body=1d6ed29 -->
     public UnitInfoDto(Unit? unit)
     {
         Id = unit?.Id;

adas-core.Domain/Models/Filter/PaginationFilter.cs

@@ -2,10 +2,21 @@
 
 public record PaginationFilter
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PaginationFilter"/> class, which encapsulates the parameters used to paginate query results.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=2ec7383 body=4448e1d -->
     public PaginationFilter()
     {
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PaginationFilter"/> class with sanitized pagination values and an optional <see cref="FilteredRequest"/>.
+    /// </summary>
+    /// <param name="pageNumber">The requested page number; values less than 1 are clamped to 1.</param>
+    /// <param name="pageSize">The requested page size; values less than or equal to 0 default to 100.</param>
+    /// <param name="filtered">The optional <see cref="FilteredRequest"/> providing additional filtering criteria.</param>
+    /// <!-- aidoc:v1 sig=9004f63 body=c312b00 -->
     public PaginationFilter(int pageNumber, int pageSize, FilteredRequest? filtered)
     {
         PageNumber = pageNumber < 1 ? 1 : pageNumber;

adas-core.Domain/Models/GroupedObservations/GroupedField.cs

@@ -10,10 +10,28 @@ namespace adas_core.Domain.Models.GroupedObservations;
 /// </remarks>
 public class GroupedField
 {
+    /// <summary>
+    /// Initializes a new default instance of the <see cref="GroupedField"/> class, representing a field that aggregates related items into a single addressable group.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=703c28d body=4448e1d -->
     public GroupedField()
     {
     }
 
+    /// <summary>
+    /// Initializes a new instance of <see cref="GroupedField"/>, which represents a configurable field for grouped observations with identifiers, scheduling offsets, and result selection.
+    /// Null collection parameters are normalized to empty lists, and <paramref name="result"/> defaults to a list containing <see cref="GroupedObservationEnum.Result.First"/> when omitted.
+    /// </summary>
+    /// <param name="name">The primary identifier of the field, or null when only the <paramref name="names"/> collection is used.</param>
+    /// <param name="names">The alternative identifiers for the field; when null, an empty <see cref="List{String}"/> is stored.</param>
+    /// <param name="group">The grouping key that associates the field with a logical group, or null if unspecified.</param>
+    /// <param name="startTimeShift">The list of schedule offsets applied to the field; when null, an empty <see cref="List{String}"/> is stored.</param>
+    /// <param name="max">The maximum number of observations retained for the field.</param>
+    /// <param name="regularity">The optional <see cref="GroupedObservationEnum.Regularity"/> that governs how observations are spaced.</param>
+    /// <param name="since">The <see cref="GroupedObservationEnum.Since"/> value that defines the schedule's starting reference.</param>
+    /// <param name="result">The list of <see cref="GroupedObservationEnum.Result"/> values the field should produce; when null, a list containing <see cref="GroupedObservationEnum.Result.First"/> is stored.</param>
+    /// <param name="labelList">The labels associated with the field, or null when no labels are provided.</param>
+    /// <!-- aidoc:v1 sig=8ca95e4 body=4742386 -->
     public GroupedField(
         string? name,
         List<string>? names,

adas-core.Domain/Models/HistoricalLocations.cs

@@ -19,6 +19,13 @@ public class HistoricalLocation : IEquatable<HistoricalLocation>
     public HistoricalLocation() { }
 
     // Tu constructor actual
+    /// <summary>
+    /// Initializes a new instance of <see cref="HistoricalLocation"/> with the specified admission time and <see cref="PatientLocation"/>, representing a historical record of a patient's location.
+    /// </summary>
+    /// <param name="admTime">The admission time assigned to <see cref="HistoricalLocation.AdmTime"/>.</param>
+    /// <param name="patientLocation">The <see cref="PatientLocation"/> assigned to <see cref="HistoricalLocation.PatientLocation"/>; cannot be <see langword="null"/>.</param>
+    /// <exception cref="ArgumentNullException">Thrown when <paramref name="patientLocation"/> is <see langword="null"/>.</exception>
+    /// <!-- aidoc:v1 sig=eaeda50 body=ebde455 -->
     public HistoricalLocation(DateTime admTime, PatientLocation patientLocation)
     {
         AdmTime = admTime;

adas-core.Domain/Models/Masters/MasterList.cs

@@ -22,6 +22,12 @@ public class MasterList
     public LocaleEnum? DefaultLocale { get; set; }
     public List<OptionList> Options { get; set; } = [];
 
+    /// <summary>
+    /// Returns a copy of this <see cref="MasterList"/> with each option name in <see cref="MasterList.Options"/> localized to the requested <paramref name="localeToReturn"/>, falling back to the original name when no translation is found.
+    /// </summary>
+    /// <param name="localeToReturn">Target <see cref="LocaleEnum"/> used to look up a translated name via reflection on <see cref="OptionList.LocaleItems"/>. When <c>null</c>, the current instance is returned unchanged.</param>
+    /// <returns>A new <see cref="MasterList"/> with localized option names when <paramref name="localeToReturn"/> is provided; otherwise the current instance.</returns>
+    /// <!-- aidoc:v1 sig=803939c body=2054117 -->
     public MasterList ReturnMasterListOptionsInLocaleIfExist(LocaleEnum? localeToReturn)
     {
         if (localeToReturn == null) return this;

adas-core.Domain/Models/MongoModels/DisplayConfig.cs

@@ -184,6 +184,12 @@ public class SmartDisplay : DisplayConfig
         }
 
     // TO TEST
+    /// <summary>
+    /// Compares the values of the public properties of <see cref="SmartDisplay"/> between the current instance and <paramref name="other"/>, and returns the names of the properties that differ. The <see cref="SmartDisplay.ColorConfig"/> property is also included when it is not null and not equal to the one in <paramref name="other"/>.
+    /// </summary>
+    /// <param name="other">The <see cref="SmartDisplay"/> instance to compare against; may be null.</param>
+    /// <returns>A <see cref="List{String}"/> containing the names of the properties that have different values between the two instances.</returns>
+    /// <!-- aidoc:v1 sig=5d5d974 body=db6cf7c -->
     public List<string> GetDifferentProperties(SmartDisplay? other)
     {
         // Obtiene las propiedades públicas de la clase SmartDisplay
@@ -858,6 +864,10 @@ public class AxisLabel
 /// <summary>
 /// Represents a line associated with an axis, typically used in charting or graphing scenarios to render or define axis-related visual elements.
 /// </summary>
+/// <summary>
+/// Represents a line associated with an axis, typically used to render or define the visual structure of an axis in a chart or graph.
+/// </summary>
+/// <!-- aidoc:v1 sig=5e39639 -->
 public class AxisLineStyle
 {
     public string? Color { get; set; }
@@ -1030,6 +1040,10 @@ public class Piece
 // /// <summary>
 // /// Represents a candle entity within the system.
 // /// </summary>
+// /// <summary>
+// /// Represents a single <c>candlestick</c> data point, typically used in financial charting to encapsulate price information for a discrete time interval.
+// /// </summary>
+// /// <!-- aidoc:v1 sig=59009c7 -->
 // public class CandlestickSeriesConfig : SeriesConfigBase
 // {
 //     public List<Candle>? CandleKeyList { get; set; }

adas-core.Domain/Models/ObservaitonRetentionResult.cs

@@ -7,10 +7,20 @@ namespace adas_core.Domain.Models;
 /// </summary>
 public class ObservatitonRetentionResult
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ObservatitonRetentionResult"/> class, which represents the outcome of an observation retention operation.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=4f5f5d1 body=4448e1d -->
     public ObservatitonRetentionResult()
     {
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ObservatitonRetentionResult"/> class, which represents the outcome of a retention evaluation, by storing the supplied <paramref name="retentionPolicy"/> and its associated <paramref name="retentionPolicyValue"/>.
+    /// </summary>
+    /// <param name="retentionPolicy">The <see cref="RetentionPolicy"/> that was evaluated to produce the result.</param>
+    /// <param name="retentionPolicyValue">The optional numeric value paired with the <paramref name="retentionPolicy"/>, or <see langword="null"/> when no value is required.</param>
+    /// <!-- aidoc:v1 sig=d280e78 body=d032d9b -->
     public ObservatitonRetentionResult(RetentionPolicy retentionPolicy, int? retentionPolicyValue)
     {
         RetentionPolicy = retentionPolicy;

adas-core.Domain/Models/Observations/Medication.cs

@@ -11,10 +11,20 @@ namespace adas_core.Domain.Models.Observations;
 /// </remarks>
 public class Medication : Observation
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="Medication"/> class with default values.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=bb98407 body=4448e1d -->
     public Medication()
     {
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="Medication"/> class, which represents medication delivery state, by reading pump-related properties from <paramref name="obj"/> when their MDC codes are present and assigning <paramref name="id"/> to <see cref="Medication.Id"/>.
+    /// </summary>
+    /// <param name="id">The identifier stored in <see cref="Medication.Id"/>.</param>
+    /// <param name="obj">A <see cref="Dictionary{TKey,TValue}"/> of <see cref="PumpElement"/> entries keyed by MDC code, consulted via <see cref="Dictionary{TKey,TValue}.TryGetValue"/>.</param>
+    /// <!-- aidoc:v1 sig=b107edc body=3412539 -->
     public Medication(string id, Dictionary<string, PumpElement> obj)
     {
         if (obj.TryGetValue("MDC_184504", out var mode)) PumpMode = new PumpMode(mode);
@@ -57,10 +67,20 @@ public class Medication : Observation
 /// </summary>
 public class DrugValue
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="DrugValue"/> class using default values. The <see cref="DrugValue"/> type represents the value associated with a drug.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=b79012f body=4448e1d -->
     public DrugValue()
     {
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="DrugValue"/> class by copying the medication-related values from the specified <see cref="PumpElement"/>.
+    /// This constructor populates the properties <see cref="DrugValue.Id"/>, <see cref="DrugValue.Text"/>, <see cref="DrugValue.Time"/>, <see cref="DrugValue.Units"/>, <see cref="DrugValue.CodingSystem"/>, and <see cref="DrugValue.Result"/> from the source element.
+    /// </summary>
+    /// <param name="pumpElement">The <see cref="PumpElement"/> from which to copy the medication data.</param>
+    /// <!-- aidoc:v1 sig=8c84a69 body=a72ec1a -->
     public DrugValue(PumpElement pumpElement)
     {
         Id = pumpElement.Id;
@@ -101,6 +121,11 @@ public class DrugValue
 /// </remarks>
 public abstract class DrugDoubleValue : DrugValue
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="DrugDoubleValue"/> class by forwarding <paramref name="pumpElement"/> to the base constructor and parsing its textual value as a <see cref="double"/> to set the Value property when the conversion succeeds.
+    /// </summary>
+    /// <param name="pumpElement">The <see cref="PumpElement"/> whose string representation is parsed as a <see cref="double"/> to initialize the Value property.</param>
+    /// <!-- aidoc:v1 sig=d14bd75 body=29c2c0d -->
     protected DrugDoubleValue(PumpElement pumpElement) : base(pumpElement)
     {
         if (double.TryParse(pumpElement.Value?.ToString(), out var valueParsed))
@@ -175,6 +200,11 @@ public class Drug(PumpElement pumpElement) : DrugStringValue(pumpElement);
 /// </summary>
 public class PumpMode : DrugStringValue
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PumpMode"/> class by forwarding the supplied <see cref="PumpElement"/> to the base constructor and computing the normalized mode identifier from its raw value. The type represents a pump mode value extracted from a pump element.
+    /// </summary>
+    /// <param name="pumpElement">The source element providing the raw mode text that is normalized to produce the mode identifier.</param>
+    /// <!-- aidoc:v1 sig=97f7b03 body=bdf432f -->
     public PumpMode(PumpElement pumpElement) : base(pumpElement)
     {
         Value = pumpElement.Value?.ToString()?.SubstringAfter("pump-mode-").Replace("-", "_");
@@ -186,6 +216,11 @@ public class PumpMode : DrugStringValue
 /// </summary>
 public class PumpStatus : DrugStringValue
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PumpStatus"/> class from the specified <paramref name="pumpElement"/>, deriving the <see cref="PumpStatus.Value"/> by stripping the "pump-status-" prefix and normalizing dashes to underscores.
+    /// </summary>
+    /// <param name="pumpElement">The <see cref="PumpElement"/> whose value is parsed to populate the status.</param>
+    /// <!-- aidoc:v1 sig=526c2d6 body=d13ab1e -->
     public PumpStatus(PumpElement pumpElement) : base(pumpElement)
     {
         Value = pumpElement.Value?.ToString()?.SubstringAfter("pump-status-").Replace("-", "_");

adas-core.Domain/Models/PatientLocation.cs

@@ -6,6 +6,13 @@
 /// </summary>
 public class PatientLocation : IEquatable<PatientLocation>
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PatientLocation"/> class, which represents a patient's location within a care unit, using the specified unit name, bed, and room values.
+    /// </summary>
+    /// <param name="unitName">The name of the care unit assigned to <see cref="PatientLocation.UnitName"/>, or <see langword="null"/>.</param>
+    /// <param name="bed">The bed identifier assigned to <see cref="PatientLocation.Bed"/>, or <see langword="null"/>.</param>
+    /// <param name="room">The room identifier assigned to <see cref="PatientLocation.Room"/>, or <see langword="null"/>.</param>
+    /// <!-- aidoc:v1 sig=401fc97 body=2b1784e -->
     public PatientLocation(string? unitName, string? bed, string? room)
     {
         UnitName = unitName;
@@ -13,6 +20,12 @@ public class PatientLocation : IEquatable<PatientLocation>
         Room = room;
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PatientLocation"/> class, storing the supplied unit name and bed, and using the bed value as the room identifier.
+    /// </summary>
+    /// <param name="unitName">The unit name to assign to <see cref="PatientLocation.UnitName"/>, or <see langword="null"/> if unspecified.</param>
+    /// <param name="bed">The bed identifier to assign to <see cref="PatientLocation.Bed"/> and <see cref="PatientLocation.Room"/>, or <see langword="null"/> if unspecified.</param>
+    /// <!-- aidoc:v1 sig=44a90e4 body=fbafeea -->
     public PatientLocation(string? unitName, string? bed)
     {
         UnitName = unitName;
@@ -20,6 +33,11 @@ public class PatientLocation : IEquatable<PatientLocation>
         Room = bed;
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PatientLocation"/> class without performing explicit initialization of its members.
+    /// The <see cref="PatientLocation"/> type represents the location of a patient.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=0911aca body=4448e1d -->
     public PatientLocation()
     {
         // Constructor vacío

adas-core.Domain/Models/PatientObservation.cs

@@ -15,10 +15,21 @@ public class PatientObservation : BasePatientObservationValue
 {
     private string? _result;
 
+    /// <summary>
+    /// Initializes a new default instance of the <see cref="PatientObservation"/> class, which represents a clinical observation recorded for a patient.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=5c55204 body=4448e1d -->
     public PatientObservation()
     {
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PatientObservation"/> class, which represents an observation linked to a patient, with the specified identifier, value, and name.
+    /// </summary>
+    /// <param name="patientId">The <see cref="ObjectId"/> identifying the patient associated with the observation.</param>
+    /// <param name="value">The value recorded for the observation.</param>
+    /// <param name="name">The name of the observation, or <see langword="null"/>.</param>
+    /// <!-- aidoc:v1 sig=6b8c74d body=a32087f -->
     public PatientObservation(ObjectId patientId, object value, string? name)
     {
         PatientId = patientId;

adas-core.Domain/Models/Responses/DisplayConfigMinimalResponse.cs

@@ -12,10 +12,20 @@ namespace adas_core.Domain.Models.Responses;
 /// </remarks>
 public class DisplayConfigMinimalResponse
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="DisplayConfigMinimalResponse"/> class, which represents a minimal response payload carrying display configuration data.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=722895f body=4448e1d -->
     public DisplayConfigMinimalResponse()
     {
     }
 
+    /// <summary>
+    /// Initializes a new <see cref="DisplayConfigMinimalResponse"/>, a minimal response view of a display configuration, from the supplied <paramref name="displayConfig"/> and optional <paramref name="isInUse"/> flag.
+    /// </summary>
+    /// <param name="displayConfig">The source <see cref="DisplayConfigSummary"/> whose <see cref="DisplayConfigSummary.Id"/>, <see cref="DisplayConfigSummary.Type"/>, and <see cref="DisplayConfigSummary.Name"/> populate the response.</param>
+    /// <param name="isInUse">The nullable boolean indicating whether the display configuration is in use, stored in <see cref="DisplayConfigMinimalResponse.IsInUse"/>.</param>
+    /// <!-- aidoc:v1 sig=017b17e body=422f274 -->
     public DisplayConfigMinimalResponse(DisplayConfigSummary displayConfig, bool? isInUse = false)
     {
         Id = displayConfig.Id;

adas-core.Domain/Models/Responses/PaginationResponse.cs

@@ -6,6 +6,14 @@
 /// <typeparam name="T">The type of the items contained in the paginated response.</typeparam>
 public class PaginationResponse<T>
 {
+    /// <summary>
+    /// Initializes a new instance of <see cref="PaginationResponse{T}"/> with the supplied page items and pagination metadata, deriving the total page count from <paramref name="totalRecords"/> and <paramref name="pageSize"/>.
+    /// </summary>
+    /// <param name="data">The <see cref="List{T}"/> of items included in the current page.</param>
+    /// <param name="pageNumber">The number of the current page.</param>
+    /// <param name="pageSize">The maximum number of items per page.</param>
+    /// <param name="totalRecords">The total number of records available across all pages.</param>
+    /// <!-- aidoc:v1 sig=bbc53e5 body=c9e44a7 -->
     public PaginationResponse(List<T> data, int pageNumber, int pageSize, long totalRecords)
     {
         PageNumber = pageNumber;

adas-core.Domain/Models/Responses/PatientSearch.cs

@@ -2,6 +2,10 @@ using adas_core.Domain.Models.MongoModels;
 
 namespace adas_core.Domain.Models.Responses;
 
+/// <summary>
+/// Encapsulates the outcome of a <see cref="Patient"/> lookup, bundling the matched <see cref="Patient"/>, the corresponding archived <see cref="Patient"/>, the related <see cref="Admission"/>, and flags that indicate archive status and result availability.
+/// </summary>
+/// <!-- aidoc:v1 sig=461ed22 -->
 public class PatientSearch(
     Patient? patient,
     Patient? archivePatient,

adas-core.Domain/Models/Responses/Response.cs

@@ -6,10 +6,19 @@
 /// <typeparam name="T">The type of the payload contained within the response.</typeparam>
 public class Response<T>
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="Response"/> class using default values.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=c192431 body=4448e1d -->
     public Response()
     {
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="Response{T}"/> class representing a successful result, setting <see cref="Response{T}.Succeeded"/> to <c>true</c>, <see cref="Response{T}.Message"/> to an empty string, <see cref="Response{T}.Errors"/> to <c>null</c>, and storing the supplied payload in <see cref="Response{T}.Data"/>.
+    /// </summary>
+    /// <param name="data">The payload to expose through <see cref="Response{T}.Data"/>.</param>
+    /// <!-- aidoc:v1 sig=f4d0833 body=8db513f -->
     public Response(T data)
     {
         Succeeded = true;