Commits
Un registre que no depèn de que ningú se'n recordi
El registro se parte en dos capas: captura y publicación
Un registre que no depèn de que ningú se'n recordi
El registre es divideix en dues capes: captura i publicació
decision
Durant molt temps vaig tenir una skill que publicava a la web i una altra que apuntava les notes a mà. Es deien gairebé igual —una amb guion i l'altra sense— i això és una bomba de rellotja: dues entrades a l'índex que es confonen de cop. Ara hi ha dos noms que diuen què fan. Una captura la feina en un journal del mateix projecte; l'altra converteix aquest journal en l'article del dia de la web. La segona capa accepta el journal directament, de manera que la feina no s'escriu dues vegades: s'escriu una veu i es publica.
Les còpies d'una skill compartida se separen soles
bug
Copiar una skill a tres perfils és un acte, no una regla. Tan bon punt un en edita la seva còpia, divergeixen: l'índex mostra dues entrades i la que carrega depèn de qui estigui usant la màquina. L'avís ja existia i era bo —ensenyava el diff, no un hash— però faltava el pas que de debò ho arregla. Ara la font de veritat és un fitxer al repositori, hi ha un instal·lador que el reparteix i una comprovació que diu, sense escriure res, quines còpies s'han quedat enrere. Ho he verificat embrutant una còpia a propòsit: el mecanisme la senyala amb el diff i, en instal·lar, torna a coincidir amb la canònica.
El journal s'omple sol amb cada commit
milestone
Fins ara el journal s'escriia a mà, que és exactament la manera de fer que un registre s'abandoni la segona setmana. Ara cada commit deixa la seva entrada sol, amb un hook de git que funciona igual des de qualsevol eina. Es recolza en dos detalls que només es veuen provant: el primer commit d'un repositori no llista els seus fitxers si no se li pregunta d'una altra manera, i un commit buit no té fitxers però continua sent un commit. I té un fre: si el commit toca només el journal, no genera una entrada nova, perquè si no el registre no pararia d'embrutar-se.
El commit s'aborta si el journal porta dades privades
milestone
El journal viu al repositori del projecte, i un repositori pot acabar sent públic. El hook que escriu el journal ho fa a la carpeta de treball, que és precisament on una dada privada s'escapa sense que ningú ho miri. Detectar-ho després no serveix de gaire si ja és dins del repositori. Així que ara, abans de cada commit, el journal es revisa i, si porta un correu amb domini real o una IP de xarxa, el commit s'aborta. Si el projecte ja té un auditor propi, s'usa aquell; si no, s'aplica un filtre mínim per forma. Les adreces d'exemple que apareixen documentant un atac que l'aplicació tanca no es consideren dades: documentar el fallo que es corregeix no és filtrar-lo.