Audit degli assunti

Rilettura di tutto ciò che ho costruito finora mettendo in discussione le scelte che non mi erano state chieste. Molte erano convenzioni assorbite, non decisioni prese. Ogni voce dice l'assunto, perché l'ho fatto, se regge, e cosa ne consegue. Le voci sono marcate con lo strato: Identità Struttura Nucleo

Il principio che avevo perso

La coppia è l'unità, non il colore

Lavorando sul celeste ero arrivato alla regola giusta: un colore non si sceglie da solo, si sceglie insieme al testo che ci va sopra. Poi sui semantici l'ho dimenticata e ho assunto che dovessero funzionare come testo su bianco. Quell'assunto li costringe tutti a essere scuri — e un giallo scuro è senape. Nessun vincolo lo imponeva: l'avevo introdotto io.

Il giallo è per natura una superficie, non un inchiostro. Con testo quasi nero sopra arriva a , molto oltre qualsiasi soglia. È il giallo vero, non un ocra di ripiego.

La famiglia semantica ripensata · ogni colore nella sua forma naturale
Completata
superficie #1E9E68
testo #08130D ·
In scadenza
superficie #F5B301
testo #1A1206 ·
Bloccata
superficie #E5484D
testo #1A0708 ·
Completata In scadenza Bloccata contro Completata In scadenza Bloccata

A sinistra la forma naturale, a destra quella che avevo imposto. La prima è più leggibile e più netta; la seconda è più sobria e non compete col bordeaux. La scelta fra le due è una decisione da prendere, non un fatto tecnico — vedi le decisioni in fondo.

La conseguenza strutturale: ogni semantico ha due token, non uno. Una -surface con la sua -on, per tag e riquadri; e un -ink per quando quel significato deve comparire come testo sulla pagina (il messaggio d'errore sotto un campo). Sono usi diversi e chiedono valori diversi. Un solo token per entrambi è ciò che mi ha portato alla senape.

Colore

01I semantici devono essere leggibili come testo su biancoNucleo

Assunto mai dichiarato. Nasce dal considerare il colore come una proprietà del testo invece che di una coppia. Costringe ogni semantico a essere scuro, e produce la senape che hai contestato.

CadeSi separa in due token per significato: superficie e inchiostro. Il giallo esiste solo come superficie.
02Il testo su una superficie colorata è biancoNucleo

È il default più diffuso e il più costoso. Il bianco funziona solo su superfici scure: sul celeste, sul giallo e su un verde medio fallisce. Applicarlo per abitudine ha prodotto sia il problema del celeste dominante sia quello della senape.

CadeOgni superficie dichiara il proprio -on. Regola già scritta per il brand, ora estesa a tutto.
03La soglia è WCAG AA, 4,5:1Nucleo

L'ho usata come obiettivo. Per un applicativo usato otto ore al giorno AA è un pavimento normativo, non un traguardo. Il testo corrente dovrebbe puntare a 7:1, che con inchiostri neutri su bianco non costa nulla.

Da deciderePropongo: 7:1 per il testo corrente, 4,5:1 minimo per il resto, 3:1 per i tratti.
04Le serie dei grafici possono usare rosso e verde insiemeNucleo

Errore vero, non stilistico. La scala che ho scritto mette #8E3037 e #12734E nella stessa legenda: per chi ha una carenza rosso-verde sono quasi lo stesso colore — fra loro stanno a 1,37:1 di luminanza. Riguarda circa un uomo su dodici. Non l'ho mai verificato.

CadeLe serie si distinguono per luminanza oltre che per tinta, e ogni grafico riporta l'etichetta diretta invece della sola legenda a colori.
05Ogni prodotto usa entrambi i colori di marcaIdentità

Mai chiesto. Un prodotto potrebbe usare solo la dominante e nessun co-primario, restando riconoscibile. Il co-primario obbligatorio è una scelta, non un dato.

Da decidereServe una risposta dal team brand.

Tipografia

06Un gestionale denso vuole testo piccoloStruttura

È l'assunto che hai contestato, ed è sbagliato. Viene dal SaaS web, dove 13px è la norma perché la pagina deve sembrare "professionale". Ma la densità si ottiene con interlinea e spaziatura, non rimpicciolendo i caratteri: comprimere il testo riduce la velocità di lettura senza far entrare molto di più.

Un applicativo di lavoro ha utenti che ci passano la giornata, spesso su schermi mediocri, spesso non giovanissimi. La base ragionevole è 15–16px, non 13. Le etichette non scendono sotto 13.

CadeScala rifatta dal basso: corpo 15px, pavimento 13px. Vedi Tipografia.
13px · etichettaResponsabile commessa
15px · corpoRistrutturazione sede di Milano
16px · corpo+Ristrutturazione sede di Milano
12px · vecchioRistrutturazione sede di Milano — quanto usato finora
07Il font dell'applicativo è il font del marchioIdentità

Mai messo in discussione: Barlow c'era e l'ho tenuto. Ma Barlow è una grottesca leggermente stretta e con occhio medio contenuto, disegnata per titoli e comunicazione. Su interfacce dense, a corpi piccoli, perde: le forme si chiudono e i numeri si somigliano.

Soprattutto: il font del marketing non deve per forza essere il font dell'applicativo. È esattamente la distinzione fra identità e struttura che regge tutto il documento. Barlow può restare sulla testata e sui titoli, con una famiglia più adatta al lavoro nel corpo e nei dati.

RisoltoScelta IBM Plex Sans + Mono: nata per il software gestionale, licenza OFL. Barlow resta al marketing. Vedi Tipografia.
08Un solo font bastaStruttura

Su un prodotto pieno di importi, date e codici serve una seconda famiglia a cifre tabulari. L'ho introdotta di soppiatto come --font-data senza dichiararla una scelta.

Regge, ma va dichiaratoDue famiglie: testo e dati. La terza sarebbe di troppo.
09Le micro-etichette vanno maiuscole e spaziateStruttura

Vezzo mio, ripetuto ovunque a 9–10px. Il maiuscoletto spaziato rallenta la lettura perché elimina il profilo della parola, e a quei corpi è al limite del leggibile. L'ho usato per far sembrare il documento ordinato.

CadeEtichette in tondo 13px peso 500; il maiuscolo resta per ciò che orienta, a 13px con spaziatura. Regole complete in Tipografia.

Interfaccia

10Un solo pieno per schermataStruttura

L'ho scritta come legge. È una buona guida, ma una barra strumenti con due azioni di pari rango la rende artificiosa, e in un elenco con azioni di riga diventa impraticabile.

DeclassareDa regola a criterio: una sola azione primaria per area di decisione, non per schermata.
11Raggi 3/5/8Identità

Li ho cambiati da 12/16/22 su tua indicazione di gusto, ma non so se i valori del v1 venissero dal brand manual. Se erano prescritti, ho derogato senza mandato. È la domanda che ho fatto due volte e che resta aperta.

Da decidereServe sapere se i raggi sono identità o struttura.
12Lo stato si comunica col colore del trattoNucleo

Nella tabella che ho disegnato, "Completata" e "Bloccata" si distinguono solo per colore: stessa forma, stessa posizione, stesso peso. Per un daltonico sono identiche. È una violazione WCAG 1.4.1, e l'ho introdotta proprio mentre scrivevo che il contrasto viene prima di tutto.

CadeLo stato porta sempre una parola; il colore rinforza, non informa. Dove serve sintesi, un contrassegno di forma diversa per stato.
13Tutto a tratto è meglioStruttura

La direzione è giusta e la confermo, ma portata all'estremo ha un rovescio: una pagina di soli filetti da 1px appiattisce la gerarchia — tutto ha lo stesso peso e l'occhio non trova l'ancora. Nella mia pagina i tre avvisi hanno esattamente la stessa forza del contenuto attorno.

Regge, con correttivoLa gerarchia la fa lo spessore (1px riposo, 2px enfasi) e lo spazio, non solo il colore.

Comportamento — lo strato che manca

Questa è la parte più importante, ed è quella su cui non ho scritto niente. Il documento dice che il nucleo non si deroga mai, e finora il nucleo è composto da tre note sul colore. Tutto quello che segue è assente dal v2, ed era in gran parte assente anche dal v1.

14Cosa fa una schermata quando i dati non arrivanoNucleo

Quattro casi distinti che vengono sempre confusi: vuoto per la prima volta (non hai ancora creato nulla), vuoto per filtro (i tuoi criteri non danno risultati), in caricamento, errore. Chiedono risposte diverse: il primo invita, il secondo offre di azzerare i filtri, il terzo non deve far saltare il layout, il quarto deve dire cosa è successo e come riprovare. Il v1 aveva una sola schermata vuota generica.

MancaDa scrivere: quattro stati, per ogni contenitore di dati.
15Quando e come si valida un campoNucleo

Ho disegnato lo stato di errore di un campo senza mai dire quando compare. Validare a ogni tasto punisce chi sta ancora scrivendo; validare solo all'invio fa scoprire sei errori insieme. La regola sensata — validare all'uscita dal campo, e da lì in poi in tempo reale — non è scritta da nessuna parte.

MancaDa scrivere: tempi di validazione, forma del messaggio, dove va il fuoco quando l'invio fallisce.
16Come si scrive nell'interfacciaNucleo

Ho scritto decine di micro-testi seguendo un mio gusto, senza codificarlo. Eppure è letteralmente il vostro messaggio portante: quel che rende riconoscibile un applicativo del gruppo è il comportamento, e il testo è comportamento. Servono regole su: dare del tu o del lei, i bottoni che dicono il verbo invece di "OK", i messaggi d'errore che dicono cosa fare invece di cosa è andato storto, le maiuscole nei titoli, i termini del dominio da usare sempre uguali.

MancaÈ il capitolo che vale di più e costa meno.
17Tastiera, fuoco, lettori di schermoNucleo

Ho definito un anello di fuoco e mi sono fermato lì. Mancano: ordine di tabulazione, cosa succede al fuoco quando si apre e si chiude un pannello, scorciatoie, come si annuncia un errore, se una tabella è navigabile senza mouse. Chi inserisce dati tutto il giorno non usa il mouse: è la differenza fra uno strumento veloce e uno lento.

MancaDa scrivere.
18Azioni distruttive e lavoro non salvatoNucleo

C'è una modale di conferma nel v1, ma nessuna regola su quando serve una conferma e quando serve invece poter annullare. La conferma preventiva su tutto abitua a cliccare "sì" senza leggere; l'annullamento dopo l'azione protegge davvero. Manca anche cosa succede se si abbandona una pagina con modifiche in sospeso.

MancaDa scrivere.
19Il prodotto si usa su un desktopStruttura

Ho lavorato solo a larghezza piena. Ma negli esempi ricorrono cantieri, sopralluoghi, rilievi: una parte del lavoro accade in piedi, con una mano sola, magari coi guanti. Il v1 aveva una shell mobile, il v2 no. Serve sapere quali funzioni vivono davvero sul campo.

RisoltoContesto primario: applicativi web tipo ERP, desktop. Il lavoro sul campo esce dai requisiti.
20Basta rispettare le WCAGNucleo

Non ho mai chiesto se vi si applica la normativa italiana sull'accessibilità (Legge Stanca, EN 301 549) — cosa probabile se lavorate con committenti pubblici o grandi imprese. Se si applica, non è una buona pratica ma un obbligo con verifica, e cambia il modo in cui il documento va scritto: servono criteri verificabili, non consigli.

Mancano comunque, a prescindere: ingrandimento al 200% senza perdita di contenuto, dimensioni minime dei bersagli tattili, rispetto della preferenza per il movimento ridotto.

Da decidereDomanda per voi: c'è un obbligo normativo?

Metodo

21Sto producendo la cosa giustaStruttura

Mi hai descritto tre documenti che circolano in PDF più file di regola che vivono nel codice. Io sto producendo pagine dimostrative: utili per decidere, ma non sono né l'uno né l'altro. Vanno bene come banco di prova, a patto di sapere che la conversione va ancora fatta.

Da decidereQuando passiamo dal banco di prova ai documenti veri?
22I tre strati sono chiariNucleo

Li ho marcati su tre note in croce. Fatto seriamente, ogni singola regola porta il suo strato — ed è la cosa che rende il documento utile, perché chi legge sa subito se quella riga è negoziabile. Questa pagina è il primo tentativo di farlo davvero.

ConfermatoDa applicare a tutto, non a campione.

Le decisioni che servono da voi