Înapoi la jurnal

O singură sursă pentru jurnalul bilingv

Pe 28 și 29 august, am simplificat felul în care bogdanalin.com transformă articolele jurnalului în pagini publice. Fiecare articol trebuia deja să apară în mai multe locuri: o pagină în engleză, una în română, arhive, fluxuri de abonare și sitemap. Păstrarea fișierelor derivate alături de textul redactat făcea mai greu de urmărit ce schimbări aparțin articolului și ce schimbări sunt doar consecințe ale construirii site-ului.

Schimbarea finalizată a păstrat fișierul JSON datat drept sursă canonică. Procesul obișnuit de build citește această sursă și produce paginile jurnalului și fișierele asociate în directorul destinat publicării. Fișierele generate nu mai trebuie editate sau salvate în istoricul Git ca o versiune paralelă a aceluiași articol. Narațiunile în engleză și română rămân împreună în sursă, unde datele, linkurile și sensul lor pot fi revizuite împreună.

Eliminarea fișierelor generate din Git era utilă numai dacă website-ul rezultat rămânea echivalent. Am adăugat și rulat verificări pentru generarea de la zero, repetabilitatea rezultatului și separarea dintre fișierele redactate și produsele build-ului. Revizuirea finală a întărit și limitele privind locurile în care pot fi scrise rezultatele. Evidențele datate de acceptare consemnează verificări focalizate și verificarea locală completă; ele nu înlocuiesc observarea producției.

Schimbarea a rămas limitată la jurnal. Paginile existente cu detalii despre proiecte și-au păstrat propriul flux de generare. Distincția contează: o simplificare se poate transforma într-o migrare a unor sisteme fără legătură dacă termenul comun generat devine singurul motiv pentru a schimba totul. Aici, limita restrânsă a clarificat modelul sursei fără să impună același traseu întregului conținut.

Reflecție

Pentru mine, simplificarea utilă nu a însemnat doar mai puține fișiere urmărite în Git. A însemnat un răspuns mai clar la întrebările unde se află articolul și cum sunt produse formele lui publice. O singură sursă revizuită, cu rezultate reproductibile, este mai ușor de întreținut decât mai multe copii editabile care trebuie sincronizate.