# 50.000 palabras de documentación de software

Redacté 50.000 palabras de documentación completa del software con Markdown en GitHub, Craft y Confluence, preservando el conocimiento y la transparencia del proceso.

2022 – 2024

Situación. La mayor parte del conocimiento importante del producto y de la forma de trabajar estaba en la memoria de las personas. Eso funciona hasta que alguien se incorpora o se marcha; entonces la incorporación se ralentiza y basta una dimisión para perder definitivamente parte de la memoria de la organización.

Tarea. El objetivo era trasladar ese conocimiento a documentación que las personas conservaran y utilizaran: suficientemente clara para leerla y estructurada para mantenerla, sin abandonarla al cabo de un mes.

Acción. Se redactó gran parte a mano, unas 50.000 palabras al terminar, en Markdown repartido entre GitHub, Craft y Confluence según correspondía. Se cubrieron la arquitectura, los procesos y las instrucciones prácticas, es decir, las preguntas recurrentes. La documentación quedó bajo control de versiones y, con la misma importancia, fácil de encontrar: una documentación que nadie puede localizar es como si no existiera.

Resultado. El conocimiento dejó de ser frágil. Las nuevas incorporaciones avanzaron más rápido, los procesos pasaron a poder consultarse en lugar de reconstruirse de memoria y el conjunto se volvió auditable: era posible ver cómo y por qué se trabajaba en lugar de tener que aceptarlo por confianza.

Función: Responsable de producto y desarrollo de proyectos
=> /es/categories/team-leadership/ Categorías: Dirección de equipos
=> /es/categories/technical-leadership/ Categorías: Dirección técnica
=> /es/categories/mentoring/ Categorías: Mentoría y acompañamiento
=> /es/categories/documentation/ Categorías: Documentación
=> /es/services/technical-leadership/ Servicios: Dirección técnica y consultoría
=> /es/services/technical-documentation/ Servicios: Documentación técnica

=> https://advisory.engineer.company/es/portfolio/wrote-50000-words-of-software-documentation/ Esta página en la web
