# 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
- Categorías: [Dirección de equipos](https://advisory.engineer.company/es/categories/team-leadership/), [Dirección técnica](https://advisory.engineer.company/es/categories/technical-leadership/), [Mentoría y acompañamiento](https://advisory.engineer.company/es/categories/mentoring/), [Documentación](https://advisory.engineer.company/es/categories/documentation/)
- Servicios: [Dirección técnica y consultoría](https://advisory.engineer.company/es/services/technical-leadership/), [Documentación técnica](https://advisory.engineer.company/es/services/technical-documentation/)

<https://engineer.company/es/portfolio/wrote-50000-words-of-software-documentation/>
