Checklist per tutorial con screenshot: acquisizione, modifica, controllo ed esportazione

Questa checklist copre l'intero flusso di documentazione visiva per un tutorial con screenshot. Usala per confermare l'ambito, preparare lo schermo, acquisire i passaggi, modificare la sequenza, proteggere i dati privati, far provare la guida a un nuovo lettore e controllare l'esportazione finale.

In breve: un tutorial è pronto quando un lettore può partire dalla condizione dichiarata, seguire ogni azione senza aiuto esterno, raggiungere il risultato promesso e aprire un file finale pulito e privo di dati privati.

Ambito e pianificazione

Questo controllo mantiene il tutorial concentrato su un solo risultato finale. Completalo prima di aprire lo strumento di acquisizione.

• Il titolo indica un'attività o una decisione.
• Il primo paragrafo dichiara il risultato e l'ordine delle azioni principali.
• La condizione iniziale è esplicita.
• Il risultato finale è visibile o misurabile.
• Il lettore previsto e l'esperienza richiesta sono chiari.
• Prerequisiti, autorizzazioni e dati di prova sono pronti.
• Risultati, ruoli o sistemi distinti hanno guide proprie.
• Il metodo di acquisizione è adatto all'attività: manuale, acquisizione dei clic o video.

Preparazione dello schermo

Questo controllo evita problemi prevedibili di privacy e coerenza. Eseguilo sullo stesso Mac e con lo stesso stato dell'account che userai per l'acquisizione finale.

• È in uso un account di prova o dati di esempio sicuri.
• Notifiche e applicazioni estranee sono chiuse.
• Scrivania, Dock, schede del browser, file recenti e barre dei titoli non espongono dati.
• L'app usa tema, lingua, dimensioni della finestra e zoom previsti.
• Le autorizzazioni e i flag delle funzioni corrispondono al percorso del lettore.
• Puntatore e disposizione delle finestre non coprono comandi importanti.
• Gli stati iniziale e finale sono stati verificati una volta prima dell'acquisizione.

Acquisizione

Questo controllo associa a ogni azione necessaria uno stato visivo utile. Esegui l'attività a un ritmo normale e seleziona in seguito il risultato.

• Lo stato iniziale è acquisito quando serve al lettore.
• Ogni azione o decisione necessaria ha un passaggio.
• I clic accidentali e le transizioni estranee sono contrassegnati per la rimozione.
• Menu, avvisi, valori e stati di conferma importanti sono visibili.
• I movimenti o i tempi che un'immagine statica non può mostrare hanno un breve video o una spiegazione separata.
• La sessione termina con il risultato promesso.
• Le acquisizioni sorgente sono conservate separatamente dal file finale.

Action Capture salva lo stato dell'elemento subito prima di ogni clic accettato e ne contrassegna la posizione. Free supporta 5 passaggi salvati per sessione, mentre Pro elimina questo limite. La checklist non cambia tra i due piani, perché il controllo della qualità avviene dopo l'acquisizione.

Sequenza e scrittura

Questo controllo rende la guida comprensibile senza dipendere dalla memoria dell'autore. Leggi soltanto le intestazioni e la prima frase di ogni paragrafo prima di passare ai dettagli.

• I passaggi seguono l'ordine in cui il lettore li esegue.
• Ogni passaggio inizia con un'azione o una condizione osservabile.
• Le etichette dell'interfaccia corrispondono esattamente al prodotto attuale.
• Sono presenti valori, scelte e scorciatoie da tastiera necessari.
• Le azioni importanti comprendono un punto di controllo atteso.
• Le diramazioni iniziano con una condizione che il lettore può vedere o verificare.
• Spiegazioni ripetute e riempitivi sono stati rimossi.
• La conclusione conferma il risultato finale e indica un passaggio successivo utile.

Immagini e annotazioni

Il controllo visivo conferma che ogni immagine riduca l'incertezza. Visualizza l'anteprima degli screenshot alla larghezza prevista nell'articolo, nel PDF o nel messaggio di assistenza finale.

• La schermata pertinente e l'elemento di destinazione sono abbastanza grandi da leggere.
• Il ritaglio o Action Focus conserva abbastanza contesto da riconoscere la posizione.
• Una sola annotazione principale identifica l'azione o lo stato.
• Indicatori di clic, frecce, forme e testo non ripetono lo stesso messaggio.
• Le annotazioni non coprono etichette, avvisi, valori o risultati.
• Il testo sull'immagine rimane breve e leggibile.
• Il testo alternativo descrive lo stato utile dello schermo senza ripetere dati privati.
• Le immagini usano dimensioni, stile e colore di accento coerenti.

Privacy e sicurezza

Il controllo della privacy riguarda il file esatto che verrà condiviso. Esamina la schermata principale e i piccoli dettagli che la circondano.

• Non sono visibili password, token, codici di recupero, codici di licenza o dati di pagamento.
• Non sono visibili informazioni non necessarie su clienti, dipendenti, salute o account.
• Schede private, percorsi, notifiche, miniature e anteprime dei messaggi sono stati rimossi.
• Ritaglio, sfocatura o rimozione completa sono adeguati alla sensibilità del dato.
• Il file finale appiattito non può rivelare un livello originale nascosto.
• Le azioni rischiose o distruttive hanno avvisi e condizioni di arresto.
• Il materiale ad alto rischio è stato controllato da una seconda persona per la privacy.

Prova con un nuovo lettore

La prova con un lettore è il controllo più efficace contro le supposizioni nascoste. Scegli una persona che non ha partecipato alla scrittura o all'acquisizione della guida.

• La persona parte dai prerequisiti documentati.
• L'autore non dà suggerimenti verbali.
• La persona riesce a trovare ogni comando nominato.
• Ogni punto di controllo corrisponde a ciò che appare sullo schermo.
• La persona sa che cosa fare quando si verifica una diramazione documentata.
• La persona raggiunge il risultato finale promesso.
• La prima esitazione o svolta sbagliata viene annotata e corretta.
• Dopo le correzioni, l'intera guida viene provata di nuovo.

Esportazione e consegna

Questo controllo conferma che i contenuti revisionati sopravvivano al formato e al canale scelti. Apri il file nello stesso modo in cui lo riceverà il lettore.

• L'ordine delle pagine corrisponde all'editor.
• Le immagini rimangono nitide allo zoom normale.
• I nomi dei file e i titoli delle pagine sono significativi.
• I link funzionano e rimandano a pagine visibili.
• Il formato è adatto alla stampa, all'uso offline, all'help center o alla condivisione di file.
• Le dimensioni del file sono compatibili con il canale di consegna.
• Il formato PDF, PNG, JPG, WebP o ZIP scelto è completo.
• La versione del prodotto verificata, il responsabile e la data di controllo sono registrati.

Il tutorial è pronto quando tutti i controlli necessari sono superati oppure hanno un'eccezione documentata. Consulta Come creare una guida passo passo dai clic su Mac per l'intero flusso di produzione e Action Capture per i dettagli della funzione Shotomatic.