Development log

¿Qué se decidió, cuándo y por qué, incluyendo los cambios de opinión? Escrito a medida que el trabajo se desarrolla, razón por la cual contiene cosas que un relato retrospectivo habría "limpiado".

El registro de desarrollo guarda decisiones en lugar de confirmaciones (commits). No registra qué cambió—el historial del sistema de control de versiones ya indica eso—, sino por qué cambió de esa manera, y cuál fue el costo de la alternativa.

Se escribe durante el trabajo, no se reconstruye después. Eso es lo que lo hace valer la pena leer y lo que a veces lo hace un poco torpe: las correcciones están aquí también, con la justificación que las motivó; incluso esta misma declaración sobre la posición de este proyecto fue reescrita en el mismo lugar, no añadida debajo de la anterior.

El registro es un archivo continuo en el repositorio, publicado aquí de forma anual. Las entradas están en orden cronológico inverso, cada una con fecha, y cada fecha puede verificarse contra el historial del repositorio.

docs/JOURNAL.md en el repositorio público; esta página es una copia de él, no un resumen.