Ogni dicembre qualche centinaio di migliaia di sviluppatori affronta Advent of Code e buona parte di loro pubblica le proprie soluzioni. Quasi sempre come immagini, e quasi sempre con la misura sbagliata.

Il motivo per cui vincono le immagini è semplice: la maggior parte delle piattaforme rovina il codice incollato — l'indentazione crolla, i colori della sintassi spariscono e una one-liner elegante diventa una macchia illeggibile. Un'immagine sopravvive a tutto questo. Il compromesso però è reale e va detto: un'immagine non si può copiare, cercare né far leggere a uno screen reader, quindi pubblica anche un link al sorgente.

Pubblica la parte interessante, non l'intero file

L'errore più comune è fotografare tutto il file della soluzione. Nessuno legge un'immagine da 60 righe sul telefono. Le soluzioni di Advent of Code contengono quasi sempre una sola idea interessante: il parsing, la ricorrenza, il trucco che ha trasformato la forza bruta in qualcosa di istantaneo. Fotografa quella e lascia che sia il link al repository a portare il resto.

Dieci-quindici righe sono il tetto di ciò che resta leggibile in una timeline.

Dimensiona per la piattaforma, non per il tuo schermo

È qui che cade la maggior parte delle immagini di soluzioni. Uno snippet che sta benissimo su un monitor da 27 pollici diventa testo in corpo sei dentro un feed.

  • Un post in timeline vuole 16:9 o 4:3. Più largo di così e il testo si rimpicciolisce per stare dentro.
  • Un feed verticale vuole 9:16 o 3:4, che tra l'altro si adatta alla forma alta e stretta che hanno comunque quasi tutte le soluzioni.
  • Ovunque conviene esportare a 2× o 3×, perché un'immagine a 1× su uno schermo retina sembra sfocata e un po' dilettantesca.

In Codeshot è la sezione Proporzioni: passa da Originale a Fisse, scegli il rapporto e imposta la scala di esportazione. Sempre gli stessi tre comandi.

Scegli un tema con contrasto

I thread di dicembre sono un muro di immagini di codice, e quelle che vengono lette sono quelle che si leggono a colpo d'occhio. I temi ad alto contrasto reggono il testo piccolo meglio di quelli delicati. Tokyo Night, Atom One e Solarized tengono botta una volta rimpiccioliti; diversi temi meno contrastati no.

Puoi confrontarli tutti e 30 qui prima di sceglierne uno per il mese.

Resta coerente per tutti i 25 giorni

Se pubblichi ogni giorno, decidi tema, sfondo e rapporto il primo giorno e non toccarli più. La coerenza è ciò che rende riconoscibile una serie in un feed — e in pratica elimina i venti secondi di armeggiare che sono il vero motivo per cui molti mollano verso l'undicesimo giorno.

Un'app nativa qui aiuta perché ricorda la configurazione tra un avvio e l'altro. La imposti il primo, e ogni giorno successivo è incolla, esporta, pubblica.

Una nota sugli spoiler

Il creatore di Advent of Code chiede di non pubblicare soluzioni in pubblico prima che la classifica si riempia. Controlla le indicazioni dell'anno in corso e, nel dubbio, pubblica a giornata conclusa anziché durante.

Se vuoi il procedimento completo, è in Come trasformare il codice in un'immagine.