Una decisión sin su porqué es una decisión que se va a repetir mal
Escribo el porqué en el momento, no al final. Un cambio de rumbo es una entrada nueva, no un borrado — el error también es documentación.
Ver en el grafoDónde se ve6
- Mindundi
Registro de decisiones numerado desde el primer día, escrito durante la construcción; los cambios de rumbo son entradas nuevas que citan a la anterior
- Ajuntaweb 2.0
Criterios de diseño escritos antes de la primera línea de código, y decisiones numeradas durante el desarrollo, cada una superable sin borrar la anterior
- Este portfolio
Decisiones de proyecto numeradas y registros de arquitectura de la implementación; la que cambia otra la marca como superada, sin borrarla
- Intranet corporativa con acceso único
Un registro de decisiones con la razón de cada una y lo que haría falta para cambiarla
- Sistema de gestión de un banco de cepas microbianas
Decisiones de modelo consolidadas, marcando las que tienen riesgo de volver a discutirse, y la reversión de una decisión como entrada nueva que cita la anterior
- Ajuntaweb 2.0
La documentación se ordena por cuánto dura: el cómo caduca y el porqué casi nunca, y cada criterio lleva el problema que lo motivó