Merge pull request #38 from ucudal/feature/thematicunits

Added thematic units and rationalized file naming

1_Contenido/1__Contenido.md

@@ -1,9 +1,35 @@
 # 1 Contenido
 
-## 1.1 [Requisitos](./1_1__Requisitos.md)
+## 1.1 [Requisitos](./1_Contenido/1_1__Requisitos.md)
 
-## 1.2 [Diseño y Arquitectura](./1_2__Diseno_y_arquitectura.md)
+Basado en la plantilla de requisitos de Volere. Las secciones que veníamos
+usando en el documento de visión serían obligatorias aquí, luego definimos bien
+cuáles quedan.
 
-## 1.3 [Calidad](./1_3__Calidad.md)
+## 1.2 [Diseño y arquitectura](./1_Contenido/1_2__Diseno_y_arquitectura.md)
 
-## 1.4 [Gestión](./1_4__Gestion.md)
+Acá va lo que veníamos poniendo en el documento de notas de arquitectura y diseño.
+
+## 1.3 [Calidad](./1_Contenido/1_3__Calidad.md)
+
+### 1.3.1 Casos de prueba
+
+### 1.3.2 Resultados de las pruebas
+
+## 1.4 [Gestión](./1_Contenido/1_4_Gestión.md)
+
+Acá van los aspectos metodológicos, de procesos de ingeniería de software, de
+gestión del proyecto.
+
+### 1.4.1 Proceso
+
+Acá van las etapas del proyecto basado tanto en UCUAP como en lo que mandó Diego.
+
+### 1.4.2 Hitos y entregas
+
+Acá van los hitos, que se entrega en cada hito, y cuándo son los hitos. Lo
+expresamos en semanas para que sirva para todas las ediciones de proyecto.
+
+### 1.4.3 Sprints y kanbans
+
+Acá tienen que poner el kanban y los sprints.

2_Tecnicas_y_herramientas/2_1__Relevamiento.md

@@ -1,3 +1,5 @@
 # 2 Técnicas y herramientas
 
 ## 2.1 Relevamiento
+
+### 2.1.2 [Mapas mentales](./2_Tecnicas_y_herramientas/2_1_1_Mapas_mentales.md)

2_Tecnicas_y_herramientas/2_3__Modelos_de_estructura.md

@@ -1,3 +1,5 @@
 # 2 Técnicas y herramientas
 
-## 2.3 Modelos de estructura
+## 2.3 Modelos de estructura
+
+## 2.3.1 [Diagramas de clases UML](./2_3_1_Diagramas_de_clases_UML.md)

2_Tecnicas_y_herramientas/2__Tecnicas_y_herramientas.md

@@ -1,9 +1,9 @@
 # 2 Técnicas y herramientas
 
-## 2.1 [Relevamiento](./2_1__Relevamiento.md)
+## 2.1 [Relevamiento](./2_Tecnicas_y_herramientas/2_1__Relevamiento.md)
 
-## 2.2 [Modelos de arquitectura](./2_2_Modelos_de_arquitectura.md)
+## 2.2 [Modelos de arquitectura](./2_Tecnicas_y_herramientas/2_2_Modelos_de_arquitectura.md)
 
-## 2.3 [Modelos de estructura](./2_3__Modelos_de_estructura.md)
+## 2.3 [Modelos de estructura](./2_Tecnicas_y_herramientas/2_3__Modelos_de_estructura.md)
 
-## 2.4 [Modelos de comportamiento](./2_4__Modelos_de_comportamiento.md)
+## 2.4 [Modelos de comportamiento](/2_Tecnicas_y_herramientas/2_4__Modelos_de_comportamiento.md)

4_Conceptos/4__Conceptos.md

@@ -6,8 +6,10 @@
 
 ## [Caso de uso del producto](./4_Caso_de_uso_del_producto.md)
 
-## [Co-nascencia o *connascence*](./4_Connascence.md)
-
 ## [Cohesión](./4_Cohesion.md)
 
+## [Co-nascencia o *connascence*](./4_Connascence.md)
+
 ## [Evento de negocio](./4_Evento_de_negocio.md)
+
+## [Jerarquía de requerimientos](./4_Jerarquia_de_requerimientos.md)

5_Unidades_tematicas/5_1_3_Diseno_de_software.md

@@ -0,0 +1,22 @@
+# Unidades temáticas
+
+## Análisis y diseño de aplicaciones I
+
+### Diseño de software
+
+#### Lecturas
+
+[Diagramas de casos de uso
+UML](/2_Tecnicas_y_herramientas/2_4_2_Diagramas_de_casos_de_uso_UML.md)
+
+[Diagramas de clases
+UML](/2_Tecnicas_y_herramientas/2_3_1_Diagramas_de_clases_UML.md)
+
+[Diagramas de secuencia
+UML](/2_Tecnicas_y_herramientas/2_4_3_Diagramas_de_secuencia_UML.md)
+
+[Diagramas de actividades
+UML](/2_Tecnicas_y_herramientas/2_4_1_Diagramas_de_actividades_UML.md)
+
+[Diagramas de despliegue UML]
+

5_Unidades_tematicas/5_1__Analisis_y_diseno_de_aplicaciones_I.md

@@ -0,0 +1,9 @@
+# 5 Unidades temáticas
+
+## 5.1 Análisis y diseño de aplicaciones I
+
+### 5.1.1 [Proceso y elicitación de requerimientos](./5_1_1_Proceso_y_elicitacion_de_requerimientos.md)
+
+### 5.1.2 [Análisis y especificación de requerimientos](./5_1_2_Analisis_y_especificacion_de_requerimientos.md)
+
+### 5.1.3 [Diseño de software](./5_1_3_Diseno_de_software.md)

5_Unidades_tematicas/5__Unidades_tematicas.md

@@ -0,0 +1,3 @@
+# 5 Unidades temáticas
+
+## 5.1 [Análisis y diseño de aplicaciones I](./5_1__Analisis_y_diseno_de_aplicaciones_I.md)

CONTRIBUTING.md

@@ -274,8 +274,48 @@ El contenido está organizado en estas carpetas:
 
 1. Contenido
 2. Técnicas y herramientas
-3.
-4.
+3. Plantillas
+4. Conceptos
+5. Unidades temáticas
+
+Cada carpeta tiene un archivo Markdown —con extensión `.md`— cuyo nombre
+coincide con el de la carpeta y sirve como tabla de contenido de la carpeta
+—excepto que usa dos guiones bajos `__` en lugar de uno para separar el número
+del resto de nombre; esto para que quede ordenado antes de los demás archivos—:
+por ejemplo, la carpeta `4_Conceptos` tiene un archivo `4__Conceptos.md`.
+
+> [!IMPORTANT]
+> Mira la sección [Nombres de archivos](#nombres-de-archivos), más adelante en
+> este documento, para conocer más detalles sobre las convenciones sobre los
+> nombres de archivos y carpetas.
+
+En algunas carpetas el contenido está organizado de manera jerárquica, pero no
+utilizamos sub carpetas, sino que agregamos niveles a los nombres de archivos:
+por ejemplo, el tema `5. Unidades temáticas` tiene algunos de los siguientes
+niveles:
+
+* <span>5.</span> Unidades temáticas
+  * 5.1
+    * 5.1.1
+    * 5.1.2
+  * 5.2
+    * 5.2.1
+
+Los nombres de los archivos en la carpeta `5_Unidades_tematicas` comienzan con:
+
+`5_Unidades_tematicas`
+
+`5__Unidades_tematicas.md`
+
+`5_1__⋯.md`
+
+`5_1_1⋯.md`
+
+`5_1_2⋯.md`
+
+`5_2__⋯.md`
+
+`5_2_1⋯.md`
 
 ### Referencias a las fuentes
 

README.md

@@ -26,71 +26,25 @@ En esta sección va el contenido del documento entregable principal de un proyec
 TODO: Combinar lo que hay de proyecto y lo que mandó Diego D, y con con el
 template de Volere.
 
-## 1.1 [Requisitos](./1_Contenido/1_1__Requisitos.md)
-
-Basado en la plantilla de requisitos de Volere. Las secciones que veníamos
-usando en el documento de visión serían obligatorias aquí, luego definimos bien
-cuáles quedan.
-
-## 1.2 [Diseño y arquitectura](./1_Contenido/1_2__Diseno_y_arquitectura.md)
-
-Acá va lo que veníamos poniendo en el documento de notas de arquitectura y diseño.
-
-## 1.3 [Calidad](./1_Contenido/1_3__Calidad.md)
-
-### 1.3.1 Casos de prueba
-
-### 1.3.2 Resultados de las pruebas
-
-## 1.4 [Gestión](./1_Contenido/1_4_Gestión.md)
-
-Acá van los aspectos metodológicos, de procesos de ingeniería de software, de
-gestión del proyecto.
-
-### 1.4.1 Proceso
-
-Acá van las etapas del proyecto basado tanto en UCUAP como en lo que mandó Diego.
-
-### 1.4.2 Hitos y entregas
-
-Acá van los hitos, que se entrega en cada hito, y cuándo son los hitos. Lo
-expresamos en semanas para que sirva para todas las ediciones de proyecto.
-
-### 1.4.3 Sprints y kanbans
-
-Acá tienen que poner el kanban y los sprints.
-
 # 2 [Técnicas y herramientas](./2_Tecnicas_y_herramientas/2__Tecnicas_y_herramientas.md)
 
-Acá van diversas técnicas de relevamiento, de modelado como UML, BPMN, MER, etc.
-
-## 2.1 [Relevamiento](./2_Tecnicas_y_herramientas/2_1__Relevamiento.md)
-
-### 2.1.2 [Mapas mentales](./2_Tecnicas_y_herramientas/2_1_1_Mapas_mentales.md)
-
-## 2.2 [Modelos de arquitectura](./2_Tecnicas_y_herramientas/2_2_Modelos_de_arquitectura.md)
-
-## 2.3 [Modelos de estructura](./2_Tecnicas_y_herramientas/2_3__Modelos_de_estructura.md)
-
-## 2.4 [Modelos de procesos](./2_Tecnicas_y_herramientas/2_4_Modelos_de_procesos.md)
+Aquí van a encontrar diversas técnicas y herramientas de relevamiento, de
+modelado como UML, BPMN, MER, etc.
 
 # 3 [Plantillas](./3_Plantillas/3__Plantillas.md)
 
 Diversas plantillas para casos de uso, arquitecturas típicas, etc.
 
-## 3.1 [Requerimiento atómico](./3_Plantillas/3_1_Requerimiento_atomico.md)
-
-## 3.2 [Escenario](./3_Plantillas/3_2_Escenario.md)
-
 # 4 [Conceptos](./4_Conceptos/4__Conceptos.md)
 
 Definiciones en formato glosario de conceptos que se usan a lo largo del sitio y
 que nos interesa unificar.
 
-> Nota: No numeramos estas entradas para poder ordenarlas alfabéticamente en el futuro
-
-## [Caso de uso de negocio](./4_Conceptos/4_Caso_de_uso_del_negocio.md)
+> [!NOTE]
+> No numeramos estas entradas en esta sección para poder ordenarlas
+> alfabéticamente en el futuro
 
-## [Caso de uso del producto](./4_Conceptos/4_Caso_de_uso_del_producto.md)
+# 5 [Unidades temáticas](./5_Unidades_tematicas/5__Unidades_tematicas.md)
 
-## [Evento de negocio](./4_Conceptos/4_Evento_de_negocio.md)
+Agrupamos contenido en este repositorio según las necesidades de los cursos en
+los que se usa.