Commits
Un registro que no depende de que nadie se acuerde de él
El registro se divide en dos capas: captura y publicación
Un registro que no depende de que nadie se acuerde de él
El registro se divide en dos capas: captura y publicación
decisión
Durante mucho tiempo tuve una habilidad que publicaba en la web y otra que apuntaba las notas a mano. Tenían nombres casi iguales —una con guion y la otra sin— y eso es una bomba de relojería: dos entradas del índice que se confunden entre sí. Ahora hay dos nombres que dicen qué hacen. Una captura el trabajo en un diario del mismo proyecto; la otra convierte ese diario en el artículo del día de la web. La segunda capa acepta directamente el diario, de modo que el trabajo no se escribe dos veces: se redacta una única voz y se publica.
Las copias de una habilidad compartida divergen por sí solas
error
Copiar una habilidad en tres perfiles es una acción, no una regla. En cuanto alguien edita su copia, divergen: el índice muestra dos entradas y la que se carga depende de quién esté usando la máquina. El aviso ya existía y era útil —mostraba las diferencias, no un hash— pero faltaba el paso que realmente lo arreglaba. Ahora la fuente de verdad es un archivo en el repositorio, hay un instalador que lo distribuye y una comprobación que indica, sin escribir nada, qué copias se han quedado atrás. Lo verifiqué rompiendo deliberadamente una copia: el mecanismo la señala mostrando las diferencias y, al instalarla, vuelve a coincidir con la canónica.
El diario se llena solo con cada commit
hito
Hasta ahora, el diario se escribía a mano, que es exactamente la forma de hacer que un registro se abandone la segunda semana. Ahora cada commit genera automáticamente su entrada, con un gancho de Git que funciona igual desde cualquier herramienta. Se apoya en dos detalles que solo se ven al probarlo: el primer commit de un repositorio no lista sus archivos si no se le pregunta de otra manera, y un commit vacío no tiene archivos, pero sigue siendo un commit. Y tiene un freno: si el commit toca únicamente el diario, no genera una entrada nueva, porque, de lo contrario, el registro no dejaría de ensuciarse.
El commit se aborta si el diario contiene datos privados
hito
El diario vive en el repositorio del proyecto, y un repositorio puede acabar siendo público. El gancho que escribe el diario lo hace en el directorio de trabajo, que es precisamente donde un dato privado se escapa sin que nadie lo advierta. Detectarlo después no sirve de nada si ya está dentro del repositorio. Así que ahora, antes de cada commit, se revisa el diario y, si contiene una dirección de correo con un dominio real o una dirección IP de red, el commit se aborta. Si el proyecto ya tiene un auditor propio, se usa ese; si no, se aplica un filtro mínimo basado en el formato. Las direcciones de ejemplo que aparecen al documentar un ataque que bloquea la aplicación no se consideran datos: documentar el fallo que se corrige no es filtrarlo.