Fișierele care mint.

Îmi verific documentele ca și cum ar putea minți. Nu din paranoia, din experiență: uneori chiar mint.

Fiecare document de sistem din studioul meu poartă o versiune scrisă în el, cu data ultimei ediții reale. Regula e simplă: data din antet trebuie să corespundă cu ultima oară când conținutul chiar s-a schimbat. La început o verificam după data de pe disc a fișierului, dar data asta se schimbă și la o simplă sincronizare de folder, fără ca vreun cuvânt din document să se fi mișcat. Aveam nevoie de o sursă mai de încredere, așa că am construit un al doilea control, care compară antetul cu istoricul real al fișierului: fiecare salvare înregistrată, cu ce s-a schimbat în ea (un commit).

Prima rulare a găsit opt documente cu antetul în urma istoriei lor. Am deschis fiecare diff, adică comparația dintre versiunea veche și cea nouă, unul câte unul. Nu am presupus nimic din numărul opt.

Șase din opt nu aveau nimic real în urmă. Fuseseră atinse de o singură trecere automată, care scosese dintr-o dată un semn de punctuație interzis din toate documentele studioului deodată: o corectură mecanică de stil. Instrumentul construit tocmai ca să nu mai creadă orbește o dată de pe disc era gata să creadă orbește orice commit din istoric, indiferent dacă schimba o decizie sau un singur caracter. Dacă mă opream la numărul opt, fără să deschid vreun diff, aș fi luat toate cele opt drept drift real și aș fi corectat manual șase antete care nu aveau nimic de corectat.

Am exclus acea trecere din verificare și am rulat din nou. A mai rămas un document. Diff-ul lui arăta altă corectură automată, de data asta pe ghilimele, comisă în același commit cu o actualizare complet fără legătură, despre bani. Cele două schimbări, una de conținut real, una de stil, călătoreau împreună într-un singur commit, cu un singur mesaj, iar mesajul vorbea doar despre bani. Am exclus-o și pe aceasta. La a treia rulare, tot documentul, a treia corectură automată: un separator de titlu, schimbat în același commit cu niște cifre financiare dintr-un fișier fără nicio legătură cu documentul verificat.

A treia oară în aceeași sesiune am oprit lista manuală de excepții. Fiecare adăugire rezolva un caz, dar lista însăși devenea exact genul de lucru pe care încercam să-l elimin: ceva care ține doar dacă cineva o actualizează la infinit, câte un caz pe rând, de fiecare dată când apare o trecere nouă de stil. Am scris în loc un test care compară conținutul unui document înainte și după fiecare commit, ignorând punctuația care variază între treceri de stil, și decide singur dacă schimbarea a fost cosmetică sau reală. Ultima rulare a ieșit curată, fără nicio excepție nouă de adăugat.

Instrumentul care verifică dacă un document minte poate el însuși să mintă, dacă are încredere oarbă în orice atinge un byte din fișier. Un commit care schimbă un semn de punctuație arată, la nivel mecanic, identic cu un commit care schimbă o decizie: aceleași linii marcate, aceeași dimensiune de diff, același verdict dacă nu te uiți mai adânc. Felul schimbării se vede doar citind textul, linie cu linie. Am deschis fiecare diff, până am învățat ce arată o schimbare reală față de una cosmetică, apoi am scris un test care face diferența asta singur, fără să mai fie nevoie de mine de fiecare dată când apare un caz nou.

La fel stă ghidul tău de brand. Pe copertă scrie „versiunea 2.0”, dar paleta din interior e cea dinaintea ultimei colecții, iar tonul descris acolo nu mai seamănă cu ce publici. Eticheta spune că documentul e la zi. Conținutul spune altceva. Afli diferența doar dacă îl deschizi și îl compari, pagină cu pagină, cu ce faci de fapt.

Un control care te pune să corectezi de mână aceleași alarme false la fiecare rulare nu economisește muncă. O mută dintr-un loc în altul.