El archivo que editas no siempre es el que se publica
Arreglas el error, recargas, está arreglado. Alguien corre el build y tu arreglo desapareció. No lo revirtió una persona: lo sobrescribió un script que regenera el archivo que estabas editando.
Un sitio tenía tres páginas que parecían HTML normal. Eran HTML normal. También eran salida: un script leía una plantilla, la resolvía y escribía esos tres archivos en cada build. Editarlas funcionaba perfecto hasta el siguiente build, momento en el que la edición desaparecía sin rastro en el historial.
El mismo sitio tenía un archivo JavaScript en su carpeta de assets. Misma situación: se escribía desde un string dentro del script de build. Nada en ninguno de los dos archivos lo decía.
Por qué esto es peor de lo que suena
Un archivo borrado es obvio. Uno sobrescrito no, porque el archivo sigue ahí, sigue siendo válido, sigue siendo más o menos lo que recuerdas. El fallo llega después y en otro lado, y quien se lo encuentra casi nunca es quien hizo la edición.
También es el tipo de error que sobrevive a la revisión. El cambio se ve bien en el diff, porque está bien. Simplemente no va a durar.
Haz que los archivos generados se anuncien
El arreglo más barato es una línea de texto. Pon un encabezado en cada archivo generado que nombre el script que lo escribe y la fuente que sí hay que editar. Cuesta una línea y termina con toda esa clase de error para cualquiera que abra el archivo.
- Un encabezado en cada archivo generado: qué lo escribe, qué hay que editar en su lugar
- Mantén la salida generada y la fuente escrita a mano en carpetas visiblemente distintas cuando puedas
- Después de cambiar una fuente, corre el build y lee el diff: debe traer tu cambio y nada más
- Si el diff trae sorpresas, hay algo más generando hacia el mismo archivo
El hábito de construir y leer el diff es el que paga. Es como descubres que un generador que habías olvidado también escribe el archivo que acabas de tocar.
La trampa relacionada
Una vez que un archivo es generado, viene una segunda pregunta: ¿el generador produce los mismos bytes dos veces con la misma entrada? Si mete una fecha o un identificador aleatorio, cada reconstrucción muestra un diff, y un diff que siempre tiene ruido es un diff que nadie lee. Así se esconde un cambio de verdad.