La gran mentira de la documentación

“No tenemos tiempo para documentar”. Pocas frases cuestan tanto dinero en tecnología y se pronuncian con tanta tranquilidad.

La documentación técnica es una de las prácticas más discutidas en organizaciones de ingeniería. Todo el mundo acepta que debería existir, pero cuando llegan los plazos ajustados suele ser lo primero que se recorta.

La narrativa habitual es sencilla: documentar ralentiza la entrega y no genera valor visible. Pero esa idea es una trampa.

La documentación no compite con la entrega

La mala documentación sí puede ser una carga. Documentos eternos, desactualizados, escritos para cumplir, duplicados o imposibles de encontrar no ayudan a nadie.

Pero la documentación útil no compite con la entrega. La protege. Permite entender decisiones, reducir dependencias, acelerar incorporaciones, evitar errores repetidos y mantener sistemas cuando las personas cambian de equipo o de empresa.

El coste aparece después

Cuando no documentas, parece que ganas tiempo. En realidad, solo estás moviendo el coste hacia el futuro. Ese coste aparecerá cuando alguien tenga que modificar una pieza que nadie entiende, rehacer una lógica perdida, investigar una incidencia sin contexto o depender de una persona concreta para responder preguntas básicas.

La falta de documentación no elimina trabajo. Lo convierte en interrupciones, deuda técnica, reuniones, mensajes, investigación manual y riesgo operativo.

Documentar no significa escribir libros

Una buena documentación no tiene por qué ser enorme. Muchas veces basta con explicar qué hace un sistema, qué decisiones importantes se tomaron, cuáles son sus dependencias, cómo se despliega, dónde están los datos, qué riesgos existen y cómo se resuelven las incidencias habituales.

La clave no es documentarlo todo. La clave es documentar lo que permite operar, mantener y evolucionar sin depender de memoria oral.

La documentación también es diseño

Escribir obliga a ordenar. Cuando intentas documentar una arquitectura y no puedes explicarla con claridad, quizá el problema no sea la documentación. Quizá el sistema es demasiado confuso.

Por eso documentar también sirve como mecanismo de revisión. Si una solución no puede explicarse, probablemente tampoco está suficientemente pensada.

Conclusión

La gran mentira de la documentación es creer que no documentar ahorra tiempo. Puede ahorrar unos minutos hoy, pero suele multiplicar el coste mañana.

La documentación buena no es burocracia. Es infraestructura cognitiva. Ayuda a que los sistemas sobrevivan a las prisas, a las rotaciones, a los errores y al crecimiento.

No hace falta documentar más por estética. Hace falta documentar mejor para poder seguir construyendo con criterio.