Scrivere istruzioni in linguaggio chiaro

Un'istruzione chiara indica azione, dati richiesti, ordine e risultato. Usa parole familiari, spiega termini necessari e lega condizioni all'azione corrispondente. La brevità è utile solo se non sacrifica informazioni.

Cominciare dall’azione

Prima di riscrivere, definite un compito specifico. Per una modifica, l'utente deve sapere da dove iniziare, quale riferimento usare, fino a quando è possibile modificare secondo le condizioni, e cosa succede dopo l'invio. Se la regola non è chiara, definitela prima.

Ordinate i passaggi secondo la sequenza d'uso. 'Inserisci il numero dell'ordine' è specifico; 'Procedi con la pratica' è vago. Se il percorso varia, indicate la condizione prima della scelta.

Specificare i dati richiesti

'Compila correttamente i campi' non specifica cosa inserire. Indicate i dati richiesti e, se serve, il formato accettato. Separate obbligatori da opzionali.

Evitate sigle e nomi interni. Usate termini comuni se precisi; altrimenti spiegate il termine tecnico alla prima occorrenza. Titoli e nomi dei comandi devono descrivere contenuto o azione.

Istruzioni chiare vs. ambigue: confronto pratico

Scrivere messaggi utili

'Operazione non valida' non aiuta. Un messaggio utile indica il dato o passaggio errato e, se possibile, come riprovare. Distinguete tra richiesta ricevuta e azione completata.

Ad esempio, 'Richiesta ricevuta. Verificheremo la possibilità della modifica e comunicheremo l'esito' non anticipa decisioni. Il testo deve rispecchiare il processo reale e i tempi sostenibili.

Verificare la comprensione

Fate testare le istruzioni da utenti rappresentativi, chiedendo di eseguire il compito senza aiuti. Osservate dove si fermano, quali termini fraintendono e l'esito atteso. Correggete e ritestate.

Verificate che istruzione, etichetta, messaggio d'errore e conferma siano coerenti. Un testo chiaro non può abilitare azioni che il servizio non permette.