Documentation modifications

adas-core.Domain/Utils/DetailConfigExtension.cs

@@ -11,6 +11,13 @@ namespace adas_core.Domain.Utils;
 public static class DetailConfigExtension
 {
     // Método principal para iniciar la extracción
+    /// <summary>
+    /// Retrieves all unique observation names defined in the nurse rows of the specified <paramref name="config"/>.
+    /// Returns an empty list when <see cref="CardDetailsConfig.NurseRows"/> is null.
+    /// </summary>
+    /// <param name="config">The <see cref="CardDetailsConfig"/> extension target whose nurse rows are inspected.</param>
+    /// <returns>A <see cref="List{String}"/> containing the distinct observation names extracted from the nurse rows; an empty list when no nurse rows are defined.</returns>
+    /// <!-- aidoc:v1 sig=1a41350 body=9520d6e -->
     public static List<string> GetAllObservationNames(this CardDetailsConfig config)
     {
         if (config.NurseRows == null) return [];
@@ -24,6 +31,12 @@ public static class DetailConfigExtension
     }
 
     // --- Auxiliar 1: Recorre la anidación de Filas (RowDetailsConfig) ---
+    /// <summary>
+    /// Recursively extracts names from a collection of <see cref="RowDetailsConfig"/> entries, traversing both the <see cref="RowDetailsConfig.Cells"/> and nested <see cref="RowDetailsConfig.Rows"/> of each row.
+    /// </summary>
+    /// <param name="rows">The list of <see cref="RowDetailsConfig"/> instances to process.</param>
+    /// <returns>An <see cref="IEnumerable{T}"/> of <see cref="string"/> containing all names collected from the cells and nested rows.</returns>
+    /// <!-- aidoc:v1 sig=4148c6b body=c6277a5 -->
     private static IEnumerable<string> ExtractNamesFromRows(List<RowDetailsConfig> rows)
     {
         foreach (var row in rows)
@@ -43,6 +56,12 @@ public static class DetailConfigExtension
     }
 
     // --- Auxiliar 2: Recorre la anidación de Celdas (CellDetails) ---
+    /// <summary>
+    /// Recursively extracts every observation name from a <see cref="CellDetails"/>, yielding names from the current cell as well as from all its nested <see cref="CellDetails.Cells"/>. Null <see cref="CellDetails.ObservationName"/> and null <see cref="CellDetails.Cells"/> collections are safely skipped without yielding any elements.
+    /// </summary>
+    /// <param name="cell">The <see cref="CellDetails"/> whose observation names, including those of its descendant cells, should be collected.</param>
+    /// <returns>A lazily evaluated <see cref="IEnumerable{T}"/> of <see cref="string"/> containing every observation name found in <paramref name="cell"/> and its nested cells.</returns>
+    /// <!-- aidoc:v1 sig=a01fdc1 body=25dff85 -->
     private static IEnumerable<string> ExtractNamesFromCells(CellDetails cell)
     {
         // 1. EXTRAER nombres del nivel actual