Las cinco contradicciones entre mi documentación y mi código
Auditar la propia documentación contra el código en producción es incómodo y necesario. Acá están las cinco divergencias que aparecieron, qué las causó y cómo se resolvió cada una.
(Plantilla de bitácora técnica. Reemplazá el contenido, poné
borrador: false y corré node build.js.)
El problema
Qué se rompió o qué se descubrió, en concreto y sin preámbulo.
Lo que intenté primero
La vía que parecía obvia y por qué no funcionó. Esta sección es la que más se salta y la que más sirve al lector.
La solución
El cambio, con código o diagrama.
Qué queda pendiente
Con su estatuto: implementado, especificado o aspiracional. Nada se da por probado si no lo está.