Skip to content

Commit

Permalink
Some changes to the structure.
Browse files Browse the repository at this point in the history
  • Loading branch information
rbejar committed Oct 23, 2023
1 parent 50d37ac commit 870f956
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 8 deletions.
16 changes: 8 additions & 8 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Apuntes sobre Scrum para Gestión de Proyectos Software
Están generados de manera semi-automática a partir de las transparencias de clase, así que hay unas cuantas cosas que no quedan bien, o incluso algunas cosas que se pierden. También hay cosas que tienen más sentido en un contexto interactivo (una clase) que como un texto de consulta. Algunos ejemplos de cosas que no quedan totalmente bien:
Están generados de manera automática a partir de las transparencias de clase, así que hay unas cuantas cosas que no quedan bien, y algunas cosas que se pierden. También hay cosas que tienen más sentido en un contexto interactivo (una clase) que como un texto de consulta:

- Algunas partes se beneficiarían de tener secciones con más niveles de anidamiento. Pero una presentación no es un documento, así que lo que se hace es que cada tema lleva un título de nivel 1 y cada transparencia tiene su título de nivel 2.
- Esto también implica que las tablas de contenidos tienen muchas repeticiones. P.ej., si hay dos transparencias seguidas con el mismo título, las dos aparecen en la tabla de contenidos.
- Algunos diagramas que tienen flechas o textos señalando cosas en ellos, cuando estos han sido añadidos con las herramientas de LibreOffice, aparecen sin estos añadidos.
- Algunas imágenes que en las transparencias tienen un tamaño y posición concretos, quizás porque son auxiliares (p.ej., recordar un diagrama mientras se desarrollan explicaciones), se transforman en imágenes "grandes" y generalmente repetidas varias veces.
- Algunas transparencias que están solo para separar contenidos durante una presentación interactiva, o para indicar por dónde se va o lo que viene a continuación no quedan bien en un contexto de tipo documento.
- A veces hay textos que aparecen resaltados de alguna manera (p.ej., subrayados) que no lo están en el formato original. La herramienta automática de conversión hace lo que puede, pero a veces los originales tienen algunos problemas con estilos y formatos que no seven, pero que sí que están ahí en la estructura de la presentación.
- Cada título de nivel 1 corresponde con una presentación (un PDF/ODP), y cada título de nivel 2 con una transparencia dentro de ese fichero.
- Esta estructura no es ideal para un documento, pero es lo que sale de convertir unas transparencias automáticamente.
- Algunos diagramas tienen flechas o textos señalando cosas en ellos que fueron añadidos con las herramientas de LibreOffice. Estos no saldrán con esos "extras",
- La posición y tamaño de las imágenes no se puede mantener, así que en algunos casos quedan raras, descolocadas, o se repiten varias veces sin que parezca necesario.
- Algunas transparencias están solo para separar contenidos durante una presentación interactiva, o para indicar por dónde se va o lo que viene a continuación. Estas añaden redundancia innecesaria al pasarlas a un documento markdown.
- A veces hay textos que aparecen resaltados de alguna manera (p.ej., subrayados) que no lo están en el formato original. La herramienta automática de conversión hace lo que puede, pero a veces los originales tienen algunos problemas con estilos y formatos que no se ven, pero que sí que están ahí en la estructura de la presentación.

Aún con todos estos defectos, es un **work in progress**, creo que es razonablemente útil que estén en este formato, sobre el que se puede buscar y que se puede consultar fácilmente en la Web de una forma mucho más interactiva que como un conjunto de ficheros en PDF, puesto que la mayor parte de los contenidos están, y se pueden consultar fácilmente.
Aún con todos estos defectos, **creo que es razonablemente útil que estén en este formato**, sobre el que se puede **buscar** y que se puede **consultar fácilmente en la Web** de una forma mucho más interactiva que como un conjunto de ficheros en PDF. La mayor parte de los contenidos están, y se pueden consultar fácilmente, especialmente si se quiere dar un repaso rápido o tener una visión global de todo lo que se ha visto en clase.


1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,7 @@ markdown_extensions:
- md_in_html
- toc:
permalink: true
anchorlink: true
- pymdownx.arithmatex:
generic: true
- pymdownx.betterem:
Expand Down

0 comments on commit 870f956

Please sign in to comment.