I sistemi AI non possono seguire le tue istruzioni come fa una persona. Una persona legge "clicca il pulsante Impostazioni" e capisce subito. Un sistema AI ha bisogno che il testo sia strutturato in modo così pulito da rendere impossibili gli errori di estrazione. Farlo bene significa che la tua guida viene citata. Farlo male significa che l'AI la salta e raccomanda il tuo concorrente.
La differenza si riduce a tre cose: come numeri i passaggi, come usi i titoli per organizzare le informazioni e se applichi lo schema HowTo per rendere la tua struttura leggibile dalle macchine.
Come numerare i passaggi perché lettori e AI li capiscano allo stesso modo?
Ogni passaggio è un'azione. Una sola azione. Non un'azione con tre sotto-azioni nascoste dentro una frase lunga.
Scrivi in forma imperativa. Di' al lettore cosa fare: "Clicca il pulsante Impostazioni." Non "Dovresti cliccare il pulsante Impostazioni" né "Ho cliccato il pulsante Impostazioni." La forma imperativa è la più chiara per le istruzioni.
Tieni ogni passaggio a una o due frasi. Un passaggio più lungo di due frasi contiene più idee. Dividilo in passaggi separati.
Esempio di passaggio debole: "Vai su Impostazioni, che si trova nel menu in alto a destra, e cerca la sezione Sicurezza. Cliccaci sopra, poi trova l'autenticazione a due fattori e clicca su attiva."
È un solo passaggio ma contiene cinque azioni. L'AI farà fatica a estrarlo correttamente.
Versione migliore:
1. Clicca Impostazioni nell'angolo in alto a destra. 2. Seleziona Sicurezza. 3. Clicca Attiva accanto ad Autenticazione a due fattori.
Ora ogni passaggio è una sola azione. L'AI può estrarre ogni passaggio in modo indipendente e il senso resta chiaro.
Quali informazioni devono venire prima dei passaggi veri e propri?
Di' ai lettori cosa serve prima di iniziare. Mettilo in una tabella, così è facile da scorrere:
| Cosa ti serve | Dettagli |
| Tempo | 5 minuti |
| Strumenti | Telefono, email |
| Tipo di account | Va bene qualsiasi account |
Questa tabella risponde alle domande che i lettori si fanno prima di iniziare. Aiuta anche l'AI a capire se la guida è completa e se il lettore è in grado di seguirla.
Come organizzare le sezioni all'interno della tua guida how-to?
Usa titoli chiari che segnalino cosa viene dopo. "Cosa ti serve" segnala una sezione di prerequisiti. "I passaggi" segnala che arrivano le istruzioni. "Cosa fare se succede questo" segnala la risoluzione dei problemi.
Non usare titoli con i due punti o con punti interrogativi. Usa titoli semplici e diretti:
Cosa ti serve (non "Cosa ti serve: prerequisiti e strumenti") I passaggi (non "I passaggi: come configurare l'autenticazione") Problemi comuni e come risolverli (non "Risoluzione dei problemi: cosa fare se X")
Così i titoli restano puliti e segnalano chiaramente il contenuto.
Conviene inserire immagini nella tua guida how-to?
Sì, ma solo quando aggiungono chiarezza. Inserisci un'immagine quando il lettore deve vedere che aspetto ha qualcosa o dove si trova. Non aggiungere screenshot solo per avere immagini.
Se inserisci un'immagine, mettila subito dopo il passaggio che illustra. Scrivi una didascalia che descriva cosa mostra l'immagine: "Immagine: il pulsante Impostazioni si trova nell'angolo in alto a destra della pagina dell'account."
La didascalia aiuta sia i lettori sia l'AI a capire cosa stanno guardando.
Cosa fa per te lo schema HowTo?
Lo schema HowTo è un insieme di dati strutturati che dice a Google e ai sistemi AI "questa è una guida pratica con passaggi numerati". Senza schema, l'AI deve indovinare dove iniziano e finiscono i passaggi. Con lo schema, la struttura è esplicita.
Quando usi lo schema HowTo, specifichi il nome dell'attività, il tempo stimato per completarla, quali strumenti o conoscenze servono al lettore e ogni passaggio in ordine.
Questi metadati aiutano l'AI a capire non solo cosa estrarre, ma anche se la guida è completa. Se la tua guida dice che servono 10 minuti ma ha 20 passaggi, l'AI la segna come possibilmente incompleta o inesatta.
WEMASY applica lo schema HowTo in automatico quando usi il tipo di contenuto How-To, così il markup è gestito per te.
Cosa viene dopo i passaggi numerati?
Una volta completati i passaggi principali, aggiungi dettagli di supporto. Spiega perché ogni passaggio è importante o a cosa fare attenzione. Usa un sottotitolo per ogni passaggio:
Passaggio 1: clicca Impostazioni
Impostazioni è dove si trovano tutte le preferenze dell'account. Su desktop, Impostazioni compare in alto a destra. Su mobile compare nel menu hamburger.
Questi dettagli di supporto aiutano i lettori a capire il contesto senza appesantire il processo principale. L'AI può comunque estrarre solo i passaggi numerati, se serve, ma i lettori hanno il quadro completo.
Cosa va in una sezione di consigli o di approfondimento?
Se hai varianti avanzate o scorciatoie, mettile in una sezione separata dopo i passaggi principali. Così il processo di base resta pulito. I lettori che hanno bisogno della versione avanzata la trovano. I lettori che hanno bisogno solo dei passaggi di base non si confondono.
Esempio:
Avanzato: metodo più veloce per gli utenti esperti
Se lo hai già fatto, puoi saltare il passaggio 2 e andare direttamente al passaggio 3. Il sistema compilerà in automatico le impostazioni predefinite.
Come capire se la tua guida how-to è strutturata bene?
Leggi solo i passaggi numerati. Formano un processo completo e comprensibile senza altro testo? Se sì, la tua struttura è buona. Se ti serve il dettaglio di supporto per capire un passaggio, non l'hai scomposto in modo abbastanza chiaro.
Controlla anche: ogni passaggio è una singola azione? Qualcuno può seguire solo i passaggi numerati e riuscirci? Se la risposta è sì a entrambe, la tua guida how-to è pronta.
Domande frequenti
Quanti passaggi sono troppi?
Non c'è un massimo fisso. Le buone guide how-to hanno da 3 a 15 passaggi. Se ne hai 25, valuta di dividere la guida in guide più piccole e mirate. Ogni guida dovrebbe insegnare un compito completo. Con il creatore di siti di WEMASY puoi configurarlo direttamente sul tuo sito.
Ogni passaggio deve avere un'immagine?
No. Inserisci le immagini solo dove aggiungono chiarezza. Un'istruzione scritta come "Clicca il pulsante blu" può richiedere un'immagine se il pulsante è difficile da trovare. Un'istruzione come "Digita la tua password" non ne ha bisogno.
Cosa faccio se un passaggio richiede conoscenze preliminari?
Aggiungile alla sezione "Cosa ti serve" prima dei passaggi. Esempio: "Questa guida presuppone che tu abbia già creato un account." Oppure: "Ti servirà un numero di telefono per completare questa guida."
Posso usare gli elenchi puntati invece dei numeri?
Per i passaggi usa i numeri. I numeri segnalano sequenza e ordine. I puntini segnalano un elenco di elementi alla pari. I passaggi hanno un ordine, quindi usa i numeri.
Ogni quanto devo aggiornare la mia guida how-to?
Se il processo cambia, aggiorna subito. Se cambia l'interfaccia (posizione dei pulsanti, nomi dei menu), aggiorna quei riferimenti. Se hai nuovi consigli o errori comuni, aggiungili alla sezione dei dettagli di supporto.
Mi serve lo schema HowTo se la mia guida si posiziona bene anche senza?
Lo schema HowTo migliora i tassi di citazione nell'AI. Anche se la tua guida si posiziona bene, lo schema aiuta l'AI a raccomandarla. Vale la pena aggiungerlo.