Diario de desarrollo

Lo que se decidió, cuándo y por qué — cambios de rumbo incluidos. Escrito a medida que avanza el trabajo, y por eso contiene lo que un relato retrospectivo habría limado.

El diario de desarrollo recoge decisiones, no commits. No qué cambió — eso ya lo dice el historial del control de versiones —, sino por qué cambió de esa manera, y lo que habría costado la alternativa.

Se escribe durante el trabajo, no se reconstruye después. Eso es lo que hace que merezca la pena leerlo, y lo que a veces lo vuelve incómodo: los cambios de rumbo también están aquí, con la medición que los impuso.

El diario es un único archivo continuo en el repositorio, publicado aquí año por año. Las entradas van de la más reciente a la más antigua, cada una fechada, y cada fecha se puede comprobar en el historial del repositorio.

Fuente: docs/JOURNAL.md en el repositorio público — esta página es una copia, no un resumen.