Documentar un proceso desordenado no lo vuelve ordenado.
Solo hace más fácil describir el desorden.
Un manual puede explicar perfectamente diez pasos que nunca debieron existir.
Un diagrama puede mostrar con mucha claridad cómo una decisión rebota entre cinco personas sin que ninguna sea responsable.
Y una especificación detallada puede conservar una necesidad que entendimos mal desde el principio.
El problema no es la documentación.
Es pedirle que arregle decisiones que nadie quiso revisar.
Antes de escribir cómo funciona algo, conviene preguntar:
¿Por qué existe este paso?
¿Quién necesita esta información?
¿Dónde se pierde el contexto?
¿Qué decisión estamos tratando de controlar?
La documentación útil aparece después de ordenar esas respuestas y se mantiene cerca del trabajo real.
No convierte un proceso malo en uno bueno.
Pero un buen proceso sí puede producir documentación que todavía sea cierta cuando alguien la necesite.
