Documenta el porqué, no solo el cómo.

Nota de demostración.

Los comandos se pueden recuperar. La razón por la que elegiste una arquitectura concreta es mucho más fácil de olvidar. Un par de líneas de contexto marcan la diferencia.