Primer el pla, després el codi: com hem refet aquesta web

El problema

Aquesta web era una aplicació que es pintava amb JavaScript. Un navegador la veia bé, però qui la llegia sense executar JavaScript, com fan molts robots i verificadors, només hi trobava una pàgina buida. Tampoc no hi havia cap versió en anglès, ni un avís legal que digués qui n'és el titular.

Primer, el pla

Una sessió nova de Claude Code va començar escrivint un pla en una issue, abans de tocar cap fitxer. El pla deia què canviaria, per què, i com es comprovaria.

Tres revisors el van llegir alhora: el de pantalla, el de seguretat i el de legal. Cadascú hi va posar condicions. El de seguretat, per exemple, va demanar que la web no publiqués mai cap adreça interna, cap ruta local ni cap nom de repositori privat.

Les decisions de producte (quant explicar de com treballem, quins productes ensenyar, què treure) les va prendre un cofundador des del mòbil.

Què vam fer

• Cada pàgina es genera a HTML en compilar, i es llegeix sencera sense JavaScript.
• Una versió en anglès, que explica què és NORKÄRŸM, en quin estat és cada producte i com fem servir Claude.
• El nom oficial, NORKÄRŸM, a tot arreu, i la forma sense accents, NORKARYM, explicada un sol cop i a les dades per als cercadors.
• Un avís legal nou, amb les dades del titular, revisat pel revisor de legal.
• Una comprovació que fa fallar la publicació si falta una dada legal, si s'hi escapa una adreça interna o una ruta local, o si torna a aparèixer un script d'analítica.

Què vam aprendre

Quan algú et verifica, el que no té font es nota de seguida. Hi vam trobar textos antics sense font, promeses de «gratis» i un article amb un cas inventat. Ho vam treure tot.

Una prova que no falla mai no prova res. La comprovació de les dades legals tenia un error: hauria fallat sempre, fins i tot amb les dades bones. Ho vam veure fent-la passar amb dades de prova, abans de fiar-nos-en. Des d'aleshores, cada regla de la comprovació porta una mostra que ha de caçar.

Els revisors troben el que l'autor no veu. El de pantalla va veure que, sense JavaScript, una part de la portada sortia buida, i que el punt volat de «col·laboració» es llegia com una H. El de seguretat va veure que una frase d'aquesta mateixa web, «una persona aprova cada fusió», no era del tot certa, i la vam canviar per una que sí que ho és.