Come verificare se un articolo risolve il problema del lettore

Inizia con un lettore, un intento e un'attività osservabile

Scrivi la dichiarazione iniziale della verifica prima di esaminare il testo:

Lettore: [tipo specifico di persona]. Intento: [cosa vuole comprendere o decidere]. Attività: dopo la lettura, è in grado di [azione osservabile] senza aver bisogno di un passaggio o di una fonte non menzionati.

Per esempio:

Lettore: un redattore che esamina un articolo pratico per il web. Intento: determinare se la bozza aiuta il lettore a cui è destinata. Attività: applicare una verifica del percorso di completamento e registrare una decisione di pubblicazione, revisione o rifiuto con le relative motivazioni.

Questa distinzione è fondamentale. "Imparare qualcosa sulla qualità dei contenuti" è un argomento informativo, non un'attività verificabile. "Identificare il prerequisito mancante in un articolo pratico e revisionare la sezione pertinente" è invece verificabile.

Mantieni l'ambito sufficientemente circoscritto affinché il completamento abbia un punto di arrivo chiaro. Una guida può spiegare come confrontare due prodotti, preparare un documento, risolvere un problema di configurazione o scegliere tra diverse opzioni. Non ha bisogno di rispondere a qualsiasi domanda correlata per risolvere l'attività dichiarata.

Le linee guida sui contenuti e sulla pubblicazione di GOV.UK raccomandano di identificare le esigenze degli utenti e pianificare i contenuti attorno a esse. Allo stesso modo, le domande di autovalutazione di Google chiedono se il pubblico di destinazione troverebbe utili i contenuti, se i lettori impareranno abbastanza da raggiungere il proprio obiettivo e se termineranno la lettura con un'esperienza soddisfacente (Google Search Central). Questi sono spunti utili, ma il redattore deve comunque trasformarli in un test di completamento concreto.

Mappa il percorso di completamento prima di giudicare la scrittura

Elenca le azioni che il lettore deve compiere, in ordine, per portare a termine l'attività. Includi decisioni, calcoli, input, verifiche e passaggi di consegne, non solo i titoli dell'articolo.

Una mappa pratica potrebbe presentarsi così:

Quindi contrassegna ogni passaggio come coperto, parzialmente coperto o mancante. "Coperto" significa che il lettore può agire in base all'articolo, non semplicemente che l'argomento è menzionato.

Ad esempio, l'articolo su un foglio di calcolo per il bilancio potrebbe spiegare come sommare le spese, ma omettere quale periodo di tempo considerare, se le imposte vadano incluse nel totale o come gestire una fattura occasionale. Il calcolo principale è presente, eppure il percorso di completamento si interrompe nella fase di inserimento degli input.

Una tabella di verifica utile è:

Questa tabella rivela se la bozza è completa in quanto strumento. Impedisce inoltre al redattore di premiare un'introduzione brillante trascurando al contempo un prerequisito mancante.

Verifica input mancanti, presupposti e condizioni di arresto

Molti articoli pratici falliscono prima ancora della prima istruzione perché presuppongono conoscenze, accessi o condizioni che il lettore non possiede. Verifica ogni passaggio ponendoti quattro domande:

Dichiara i presupposti in modo esplicito. Se un calcolo utilizza una percentuale, definisci la base. Se una guida di configurazione dipende da una particolare versione del software, identifica la versione o la funzionalità pertinente. Se un articolo mette a confronto delle opzioni, specifica quali condizioni rendono adatta ciascuna opzione.

Separa gli input obbligatori dai miglioramenti facoltativi. Il lettore deve essere in grado di capire se un elemento è necessario per procedere o se è semplicemente utile. Colloca i prerequisiti prima della procedura, dove possono evitare inutili perdite di tempo.

Presta attenzione anche alle trasformazioni implicite. Il lettore deve convertire unità di misura, rimuovere spazi, selezionare un intervallo di date o interpretare un messaggio di errore? In tal caso, fornisci la regola o un breve esempio illustrativo. Non inventare arbitrariamente un valore per un input assente. Spiega al lettore cosa deve reperire, quale presupposto documentare o in quali casi il metodo non può essere completato.

Un articolo è più affidabile quando descrive chiaramente le condizioni di errore. "Se il risultato è vuoto, verificare che il campo di origine sia compilato" è più utile che lasciare intendere che il metodo funzioni sempre. La verifica dovrebbe registrare ogni punto in cui un lettore potrebbe ragionevolmente bloccarsi.

Verifica la copertura delle prove, non la decorazione delle citazioni

Per ogni affermazione rilevante, chiediti di che tipo di supporto ha bisogno. Una definizione potrebbe richiedere un riferimento autorevole. Un'istruzione procedurale potrebbe necessitare di un manuale ufficiale o di una specifica documentata. Una raccomandazione potrebbe richiedere criteri dichiarati e una spiegazione chiara di come tali criteri conducano alla raccomandazione stessa.

Crea un registro delle affermazioni con quattro colonne: affermazione, decisione del lettore interessata, prova utilizzata e forza della formulazione. L'ultima colonna è fondamentale. Le prove possono supportare termini come "può", "di solito" o "è richiesto", ma non automaticamente "sempre", "il migliore" o "garantito". Mantieni le condizioni e le limitazioni della fonte.

Prediligi fonti originali o dirette quando documentano l'argomento in prima persona. La spiegazione del W3C relativa al criterio di livello di lettura delle WCAG 2.2, ad esempio, afferma che i testi complessi dovrebbero disporre di una versione più facilmente comprensibile o di contenuti integrativi quando viene superato il livello di lettura specificato. Un redattore può utilizzare tale fonte per giustificare una verifica della complessità, evitando al contempo l'ingiustificata conclusione che un singolo punteggio di leggibilità renda accessibile qualsiasi articolo.

Le prove dovrebbero trovarsi accanto all'affermazione che supportano, come in quell'esempio, piuttosto che in un elenco scorrelato di fonti. Un elenco di fonti è utile per la revisione, ma non può correggere un paragrafo la cui formulazione va oltre quanto dimostrato dalle prove. Controlla date, versioni e ambiti, in particolare per le istruzioni legate a software, standard o normative.

Esamina l'usabilità e la leggibilità come parte del completamento dell'attività

Un articolo leggibile non è semplicemente piacevole: riduce l'impegno necessario per individuare, comprendere e applicare un'istruzione. Esamina la bozza dal punto di vista del suo utilizzo pratico:

Le linee guida del W3C spiegano che parole brevi e comuni e frasi più corte sono generalmente più facili da decifrare, osservando al contempo che un argomento complesso può essere appropriato per un pubblico specializzato. Ciò significa che la revisione editoriale deve ridurre le difficoltà evitabili senza sacrificare la precisione necessaria. Non semplificare fino a eliminare una condizione che modifica il risultato.

Usa tabelle per confronti ripetuti, elenchi numerati per le sequenze e paragrafi brevi per le spiegazioni logiche. Se un passaggio richiede una decisione, colloca la condizione immediatamente prima dell'azione. Se un termine è inevitabile, definiscilo alla prima occorrenza e usa sempre lo stesso termine in seguito.

Leggi l'articolo una volta scorrendolo rapidamente e una volta mettendoti nei panni di chi deve eseguire le azioni. Chi legge rapidamente deve essere in grado di identificare il risultato promesso, i prerequisiti e il percorso per raggiungere la risposta. Chi deve agire deve poter eseguire i passaggi senza dover ricostruire l'ordine inteso dall'autore.

Esegui un test con i lettori prima della pubblicazione

La verifica preliminare più efficace prima della pubblicazione è un piccolo test dell'attività con una persona che rispecchi il lettore di destinazione ma che non abbia scritto la bozza. Forniscile la definizione dell'attività e l'articolo. Chiedile di lavorare in autonomia, descrivendo a voce alta solo cosa sta cercando o di cosa ha bisogno, non se l'articolo le piace o meno.

Osserva se la persona:

Registra i punti di attrito esatti: un campo mancante, un'etichetta ambigua, una condizione ignorata, un risultato non spiegato o una dipendenza esterna. Non considerare il fatto che un lettore indovini per intuizione come una prova della chiarezza dell'articolo. Chiedi: "Cosa nell'articolo ti ha indicato di fare questo?" Se la risposta è "Lo sapevo già", la bozza potrebbe presentare ancora una lacuna.

Dopo il test, classifica ciascun problema come bloccante, rallentante o cosmetico. Risolvi prima i problemi bloccanti: prerequisiti mancanti, ambiguità rischiose, sequenza errata e assenza di percorsi per le eccezioni. Poi esegui nuovamente il test sul percorso modificato. Un test con i lettori non garantisce un'utilità universale, ma può rivelare se l'attività dichiarata sia effettivamente realizzabile da una persona diversa dall'autore.

Usa le analisi statistiche in un secondo momento e interpretale con cautela

I dati statistici possono mostrare cosa è accaduto dopo la pubblicazione — come visite, ricerche, uscite o interazioni — ma non dimostrano di per sé che il lettore abbia completato l'attività. Una visita breve potrebbe significare che la risposta è stata trovata rapidamente; una visita lunga potrebbe indicare che il lettore era disorientato. Considera i dati comportamentali come uno spunto di indagine, non come un sostituto della verifica del percorso di completamento.

Se sono disponibili dei dati, collegali a un'ipotesi specifica: "I lettori potrebbero non trovare il prerequisito", oppure "Il passaggio per la risoluzione dei problemi potrebbe non essere chiaro". Esamina la sezione pertinente, ripeti il test dell'attività e procedi alla revisione solo quando le prove supportano la modifica. Evita di trasformare una metrica in una conclusione sull'utilità senza aver osservato o comunque verificato il risultato ottenuto dal lettore.

Le linee guida di Google incentrate sulle persone invitano i creator a valutare la qualità dei contenuti, l'accuratezza delle fonti, la completezza e il raggiungimento dell'obiettivo da parte dei lettori. Queste domande sono in linea con questa verifica, ma nessun documento dei motori di ricerca può certificare che una singola bozza risolva una specifica attività. La decisione editoriale rimane fondata sulla bozza, sulle sue prove a supporto e sul percorso osservato.

Continua a esplorare il tema