Saltar al contenido
GenNarrativa

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á.