breaks: false repo: https://mutabit.com/repos.fossil/documentaton/ translations: - en: https://docutopia.tupale.co/inkit:r3p:agiledoc# - es: https://docutopia.tupale.co/documentaton:agiledoc.es# sync: - translations://es - repo://es/capitulos/doc-agil.md Pending: Traducir el documento de inglés a español.
Markdown: Documentación ágil y estructurada
{width=70%}
Introducción
Las pantallas se están volviendo más ubicuas y diversas. Tabletas, teléfonos celulares, computadores portátiles y de escritorio y los libros son aparatos donde expresamos y nos aproximamos a ideas, causas e historias. Esto configura un paisaje de medios donde estamos leyendo y escribiendo desde y para distintos aparatos y factores de forma. En tal panorama diverso, software popular, como las suites de oficina, pueden ser consumir demasiados recursos y ser extra complicadas, haciéndose inadecuadas para escritura colaborativa y/o multi-dispositivo, y esto crea una creciente tendencia a explorar otras maneras de escribir, que recobran el foco en el núcleo de la experiencia de escritura: poner palabras juntas, mientras que proveen un formato sencillo y una experiencia de usuario minimalista que aún refleja la estructura del documento y su presentación. Es por eso que hablamos acá de documentación ágil y estructurada: estas técnicas no son voraces en recursos (cognitivos o tecnológicos), pero proveen los elementos necesarios para escribir documentos estructurados jerárquicos (si es necesario), con secciones, subsecciones, capítulos, subcapítulos etc y también soportan otras formas de estructuras, como notaciones musicales o matemáticas, entre otras. Acá exploraremos uno de esas maneras ligeras de escritura, así como las herramientas para ella.
:::info ::: {.admonition}