Cada vez que alguien dice “eso lo sabe fulano”, la empresa está admitiendo una deuda.
La documentación técnica suele tener mala fama porque muchas veces se hizo mal: documentos eternos, desactualizados, escritos para cumplir y no para servir. Pero la mala documentación no invalida la necesidad de documentar. Solo muestra que hay que hacerlo con criterio.
Documentar no significa escribir una novela sobre cada cable. Significa dejar claro lo que otra persona necesita para entender, operar, revisar o recuperar un sistema sin empezar desde cero.
La memoria oral no escala
En empresas chicas, la memoria oral puede sobrevivir un tiempo. En empresas medianas y grandes, empieza a romperse. Cambian personas, cambian proveedores, cambian prioridades. Lo que no está escrito se transforma en dependencia, demora o riesgo.
La documentación útil responde preguntas simples: qué hay, para qué sirve, quién accede, dónde está, cómo se respalda, qué proveedor interviene, qué pasa si falla y qué decisiones quedaron pendientes.
También es una forma de respeto hacia el equipo. El que llega después no tiene que adivinar. El que toma decisiones puede ver contexto. El que resuelve una urgencia tiene menos margen para improvisar mal.
Una empresa ordenada no documenta todo por obsesión. Documenta lo importante porque entiende que la tecnología no puede vivir solo en la cabeza de algunos.