Vermutech #79

Aquesta setmana vaig començar-la assistint a la presentació del llibre Arquitectura medieval a la llera del Ter, on hi he escrit sobre l’església de Sant Llorenç de les Arenes. M’ha fet il·lusió participar-hi, tot i l’estrès que va suposar escriure-ho en tan poc temps.

Setmana de ple Nadal, àpats llargs i moooolt de menjar. Per la zona de l’Empordà en aquestes dates també és típic després d’aquests àpats anar a jugar a la Quina, on tens una butlleta, van cantant números i pots fer línia o bé quina. Normalment no em toca mai, però aquest any just abans de plegar em va tocar una línia! Per Nadal també és típic el concert de Mishima (ja surten al Vermutech #4), el fan a la Mirona, és un concert en format petit que hem disfrutat molt.

A nivell tècnic... vacances. Però igualment he estat pendent d’algunes coses que entraven al nostre sistema ERP, com un nou widget pels camps many2one amb comportament de selecció. Si en fas servir, ja el pots començar a provar!

💾 Programari

• ClipJS: Un editor de vídeo directament al navegador: sense registre, sense publicitat i molt senzill, però fa el que ha de fer. És codi lliure i el pots trobar a GitHub.

🤔 Curiositats

• CdImage: Ara que els CD-ROMs ja no s’utilitzen gaire, aquest programet permet fer dibuixos a la part d’escriptura. Per si vols reciclar-los en format decoració retro-tech.

📦 Recursos

• Un article de la newsletter de PostHog que entra amb ganes de desmitificar la col·laboració constant dins dels equips digitals. Posa el focus en com les eines de col·laboració, quan s’abusen o s’organitzen malament, poden convertir-se en soroll i frenar el treball real.

📊 Enquesta

La setmana passada vaig preguntar què et generava més FOMO tecnològic, i la resposta guanyadora, contra tot pronòstic, va ser… cap. Més de la meitat de respostes van declarar-se en pau digital, però just després venien les novetats en el món de la IA i les newsletters pendents, que encara mantenen la seva pressió silenciosa.

Aquestes dates conviden a fer balanç... o almenys a imaginar que el farem. Així que, entre torrons i pantalles, et proposo una pregunta per mirar cap al 2026 amb ulls tecnològics:

🌟 El concepte

Entre conceptes que apareixen de tant en tant però que no tothom coneix del tot, aquesta setmana m’ha vingut al cap docs as code.

La idea és senzilla però potent: tractar la documentació com si fos codi. Escriure manuals i guies dins de repositoris Git, gestionar els canvis amb pull requests, fer revisió entre persones de l’equip i automatitzar validacions i publicacions amb pipelines. Això fa que el contingut no es despenji mai del que realment passa al projecte, es manté viu i revisat, i tothom el pot millorar amb el mateix flux que una línia de Python o una funció nova.

L’article What Docs as Code Means ho explica amb molta claredat, i també val molt la pena fer una ullada a com GitHub ha treballat la seva pròpia documentació. Primer ho van explicar fa gairebé 10 anys a How GitHub uses GitHub to document GitHub, i avui en dia no només mantenen el sistema, sinó que l’han obert com a projecte públic: How we open sourced docs.github.com. Tot el procés està versionat, revisat i obert a contribucions externes.

A GISCE‑TI tenim aquest enfocament integrat dins dels fluxos de treball amb GitHub. La documentació dels manuals conviu amb el codi i es tracta amb el mateix procés: pull requests, revisions i automatitzacions. A més, tenim un sistema de GitHub Actions que s’encarrega de validar que les traduccions estiguin correctes, fer tests a la documentació i assegurar que cada canvi compleix uns mínims abans de publicar. Això ens permet mantenir-la sempre actualitzada, revisada i integrada dins el dia a dia del desenvolupament.

Entendre i adoptar aquest model ajuda a evitar que la documentació sigui aquella part que “ja farem després”. I tu, com la gestiones?

🎛️ Mod

Aquesta edició l’he escrita escoltant Ordre i Aventura de Mishima. La cançó que m’agrada més és Guspira, estel o carícia.

💖 Feedback

Si t’ha agradat i em vols ajudar, fes arribar aquest contingut a qui creguis que li pot interessar, i entra al canal de Telegram per comentar la publicació.