Usa questo modello
Gli articoli informativi sono il cavallo di battaglia del content marketing: istruiscono, creano fiducia e si posizionano nei motori di ricerca. Con Trupeer, puoi risparmiare ore nella scrittura di articoli informativi partendo da un modello gratuito, personalizzandolo con le tue linee guida del brand e trasformando ogni articolo in un video riassunto che i lettori possono anche guardare.
Un articolo informativo spiega qualcosa. Che cos'è una cosa, perché funziona in quel modo, qual è la differenza tra due opzioni, cosa succede dietro un processo.
Sono più difficili da scrivere rispetto alle istruzioni e falliscono in modo diverso. Una guida pratica fallisce quando qualcuno si blocca. Una spiegazione fallisce quando qualcuno finisce di leggere, crede di aver capito, e invece si scopre che non è così.
Scarica il modello di articolo informativo
Formato | Ideale per |
|---|---|
Word (.docx) | Stesura e revisione prima della pubblicazione |
Spiegazioni stampabili, documenti di briefing, dispense | |
PowerPoint (.pptx) | Spiegare un concetto in una sessione anziché in un documento |
Google Docs | Stesura con un esperto in materia |
Gratuito, modificabile, senza filigrana.
Di quale tipo di articolo hai bisogno?
Il lettore desidera | Tipo | Modello |
|---|---|---|
Capire cos'è qualcosa o perché funziona in quel modo | Informativo o concettuale | Questa pagina |
Completare un'attività specifica | Guida pratica (How-to) | |
Diventare competente in un'intera area | Guida | |
Cercare un valore o un'opzione esatta | Riferimento | |
Imparare da zero, seguendo i passaggi | Tutorial |
L'errore strutturale più comune nella documentazione è mescolare questi elementi. Una spiegazione con tre passaggi nascosti all'interno, o un insieme di istruzioni interrotte da informazioni di contesto, non serve a nessun lettore.
Perché le spiegazioni falliscono
Non perché chi scrive ne sa troppo poco. Quasi sempre il contrario.
Il lettore crede già a qualcosa. Arriva con un modello mentale, di solito incompleto e spesso errato. I fatti aggiunti a un modello errato vengono assorbiti al suo interno anziché sostituirlo, motivo per cui qualcuno può leggere una spiegazione accurata e andarsene credendo ancora a cose errate.
Chi scrive ha dimenticato com'era non sapere. Una volta capito qualcosa, la difficoltà di apprenderlo diventa invisibile. Salti il passaggio che ti aveva confuso in origine perché non ti sembra più un passaggio.
L'astrazione viene prima. Le definizioni prima degli esempi rappresentano l'ordine naturale per chi ha già capito, e l'ordine sbagliato per tutti gli altri.
La completezza viene scambiata per chiarezza. Coprire ogni singolo caso rende la spiegazione accurata e rende l'idea centrale più difficile da trovare.
Inizia da ciò che già credono
La cosa più utile che puoi fare prima di scrivere è scoprire cosa pensa attualmente il lettore.
Per un concetto di prodotto, ciò deriva dai ticket di supporto: le domande poste dalle persone rivelano il modello con cui operano. "Perché il mio report non si è aggiornato" ti dice che pensano che si aggiorni in tempo reale. Questo malinteso è ciò che il tuo articolo deve affrontare, ed è più utile di qualsiasi descrizione accurata.
Quindi scrivi la spiegazione per scardinare tale convinzione anziché per descrivere la verità. Sono due tipi di scrittura diversi. Uno riconosce ciò che le persone presumono e mostra perché non regge. L'altro afferma ciò che è vero e spera che il lettore noti il conflitto.
Nominare esplicitamente il malinteso funziona bene. "Potresti aspettarti che il report si aggiorni non appena i dati cambiano. Non è così, e vale la pena capirne il motivo."
Come personalizzare questo modello in Trupeer
Passaggio 1: Apri la sezione Modelli
Vai alla sezione Modelli dal menu di navigazione principale.
Passaggio 2: Seleziona e apri un modello
Fai clic su qualsiasi modello con cui desideri lavorare per aprirlo.
Passaggio 3: Espandi la visualizzazione del modello
Se necessario, espandi la visualizzazione del modello per vedere chiaramente il layout completo e i dettagli.
Passaggio 4: Modifica il modello
Fai clic su Modifica per iniziare a modificare il modello selezionato.
All'interno dell'editor puoi:
Aggiungere nuove sezioni
Definire o aggiornare le regole di formattazione
Aggiungere un logo e regolarne la posizione e le relative impostazioni
Passaggio 5: Salva il tuo modello personalizzato
Dopo aver apportato tutte le modifiche necessarie, fai clic su Salva per memorizzare il modello aggiornato come tuo.
Passaggio 6: Visualizza l'anteprima e perfeziona il modello
Quando desideri vedere come appare il tuo modello personalizzato, apri l'Anteprima.
Dalla schermata di anteprima, puoi continuare ad apportare modifiche direttamente se necessario, assicurandoti che il modello appaia esattamente come desideri.
Con un modello di articolo informativo puoi:
Risparmiare ore di scrittura: Salta la pagina bianca grazie a una struttura creata appositamente per i contenuti educativi.
Migliorare la SEO: Articoli ben strutturati si posizionano meglio nei risultati di ricerca.
Rimanere in linea con il brand: Applica il tuo logo, font e colori utilizzando il brand kit di Trupeer.
Coinvolgere più lettori: Associa agli articoli dei video riassunti per soddisfare diverse preferenze di apprendimento.
Standardizzare i contenuti: Utilizza lo stesso modello per i post del blog e per gli articoli della Knowledge Base.
Raggiungere lettori globali: Traduci gli articoli in oltre 65 lingue con un solo clic.
La struttura della spiegazione
Sezione | Scopo |
|---|---|
Titolo | Cosa viene spiegato, con le parole del lettore |
La risposta breve | Due o tre frasi. Ad alcuni lettori serve solo questo |
Perché ti interessa | Quale decisione o problema influenza |
La credenza comune | Cosa pensa di solito la gente, nominato esplicitamente |
La spiegazione vera e propria | Prima gli elementi concreti, poi il principio generale |
Un esempio | Uno, dettagliato e risolto |
Casi limite ed eccezioni | Dopo che l'idea principale è stata recepita, non prima |
Cosa farsene | La conseguenza pratica |
Correlati | Concetti adiacenti e la guida pratica, se presente |
La risposta breve in alto non è un riassunto dell'articolo. È proprio la risposta, per la percentuale consistente di lettori che desiderano solo quella e poi se ne andranno. Fornirla subito è corretto. L'articolo esiste per i lettori che vogliono approfondire.
Il concreto prima dell'astratto
Il miglioramento singolo più affidabile per qualsiasi spiegazione.
Le persone comprendono un principio generale molto più facilmente dopo aver visto un caso specifico di esso. Scrivere prima la definizione e poi l'esempio inverte il modo in cui la comprensione si forma effettivamente, ed è l'ordine predefinito in quasi tutta la scrittura tecnica perché è l'ordine che sembra logico a chi già conosce l'argomento.
Prima l'astratto: Il rate limiting limita il numero di richieste che un client può effettuare entro una finestra temporale definita, prevenendo l'esaurimento delle risorse e garantendo una disponibilità equa del servizio.
Prima il concreto: Se invii più di 100 richieste in un minuto, iniziamo a rifiutarle fino allo scadere del minuto. Questo evita che una singola integrazione consumi accidentalmente la capacità di cui tutti gli altri hanno bisogno. Questa restrizione si chiama rate limiting.
Il secondo non è più semplice nei contenuti. Arriva nell'ordine in cui il lettore può assorbirlo.
Le analogie e dove si interrompono
Le analogie sono lo strumento più potente nella scrittura esplicativa e quello che più probabilmente causerà un sottile malinteso in seguito.
Usane una quando il concetto è davvero sconosciuto e c'è un parallelo quotidiano molto vicino. Mantienila breve e usala una volta sola anziché estenderla per tutto l'articolo.
Poi dichiara dove si ferma. "Questo è un po' come fare la fila a uno sportello, tranne per il fatto che, a differenza di una fila ordinaria, l'ordine non è garantito." Nominare il limite evita che il lettore trascini l'analogia in territori in cui produce conclusioni errate, che è il modo in cui le analogie creano i malintesi che gli articoli successivi dovranno poi risolvere.
Se non riesci a definire dove si interrompe l'analogia, significa che non conosci ancora abbastanza bene il concetto per poterlo spiegare.
Il modello di articolo
Campo | Inserisci |
|---|---|
Titolo | Cosa spiega questo articolo |
Pubblico di riferimento | A chi è rivolto e cosa si presume che sappia già |
Risposta breve | Due o tre frasi |
Perché è importante | La decisione o il problema che influenza |
Credenza comune | Cosa crede solitamente la gente |
Spiegazione | Prima l'esempio concreto, poi il principio |
Diagramma | Laddove il concetto sia strutturale o sequenziale |
Casi limite | Dopo la spiegazione principale |
Implicazioni pratiche | Cosa fare diversamente sapendo questo |
Articoli correlati | Concetti adiacenti e qualsiasi guida pratica |
Proprietario e ultima revisione |
Inefficace vs. Migliore
Incipit inefficace: Questo articolo fornisce una panoramica della nostra architettura di sincronizzazione dei dati e dei vari fattori che influenzano la frequenza di aggiornamento nei sistemi integrati.
Incipit migliore: I tuoi dati si aggiornano ogni 15 minuti, non istantaneamente. Se hai appena modificato qualcosa e non riesci a vederlo, il motivo è questo. Qui spieghiamo come funziona la sincronizzazione e quando questa differenza è importante.
Spiegazione inefficace: Il sistema impiega un modello di consistenza eventuale per cui le scritture vengono propagate in modo asincrono tra i nodi, con una convergenza tipicamente raggiunta entro una finestra temporale limitata.
Spiegazione migliore: Quando salvi una modifica, questa viene scritta prima in un punto e copiata negli altri un momento dopo. Per alcuni secondi, parti diverse del sistema possono mostrare valori diversi. È intenzionale, perché attendere la conferma di ogni copia prima di accettare la modifica renderebbe il salvataggio molto più lento. È importante in una situazione: se salvi e generi immediatamente un report, quest'ultimo potrebbe non includere la modifica.
Struttura inefficace: definizione, storia, architettura, casi d'uso, esempi.
Struttura migliore: la risposta in una riga, perché dovrebbe interessarti, il malinteso comune, un esempio pratico, poi la regola generale e infine le eccezioni.
Lunghezza e portata
Un concetto per articolo. Se il titolo richiede una "e", ne hai due.
La maggior parte degli articoli concettuali dovrebbe essere più breve di quanto vorrebbero i loro autori. La tentazione di coprire ogni caso è fortissima in questo ambito, perché l'esperto della materia vede tutte le eccezioni e ognuna sembra importante.
Il test: qualcuno potrebbe leggere questo articolo ed essere in grado di prendere la decisione che esso influenza? Se sì, l'accuratezza aggiuntiva sta costando in termini di chiarezza più di quanto offra in valore. Sposta le eccezioni in un articolo di riferimento e inserisci il link.
Da ottocento a millecinquecento parole è un intervallo ragionevole per la maggior parte dei testi esplicativi. Se è più lungo, di solito significa che ci sono più concetti, o che un articolo concettuale ha assorbito materiale di riferimento.
Diagrammi
Gli articoli concettuali traggono vantaggio dai diagrammi più di qualsiasi altro tipo, perché gran parte di ciò che spiegano è strutturale o sequenziale.
Usane uno laddove il concetto coinvolga elementi in relazione con altri elementi, una sequenza di eventi o un confronto tra due stati. Un singolo diagramma di flusso spesso sostituisce quattro paragrafi.
Mantienilo abbastanza semplice da poter essere letto in pochi secondi. Un diagramma con venti caselle non spiega nulla che venti paragrafi non farebbero, ed è più difficile da aggiornare.
Etichetta tutto con le stesse parole utilizzate nell'articolo. I diagrammi che introducono una propria terminologia creano una seconda cosa da imparare.
Quando spiegare e quando inserire un link
Una questione sempre aperta nella maggior parte della documentazione.
Spiega inline quando il lettore non può procedere senza tale informazione, quando sono due frasi o quando l'intero scopo dell'articolo è proprio quel concetto.
Inserisci un link esterno quando si tratta di un vero e proprio concetto a sé stante, quando ne avrà bisogno solo una parte dei lettori o quando la spiegazione raddoppierebbe la lunghezza.
Non spiegare mai inline in un articolo di guida pratica. Il lettore sta eseguendo un'azione e il contesto interrompe il flusso. Inserisci un link e mantieni i passaggi puliti. Questo è il motivo principale per cui esistono gli articoli concettuali: offrono alle guide pratiche un posto dove indirizzare le persone.
Tipologie di articoli informativi
Tipo | Risponde a | Esempio |
|---|---|---|
Che cos'è | Definizione e scopo | Che cos'è il single sign-on |
Come funziona | Meccanismo | Come funziona la nostra sincronizzazione |
Perché | Logica alla base di un design o di una policy | Perché i report si aggiornano ogni 15 minuti |
Confronto | Differenza tra due cose | Piani standard vs. premium |
Quando usare | Guida alle decisioni | Quando usare uno spazio di lavoro anziché una cartella |
Contesto | Contesto di una modifica | Perché siamo passati al nuovo modello di autorizzazioni |
Gli articoli sul "perché" sono i più preziosi e i meno scritti. La maggior parte della documentazione spiega il "cosa" e il "come", lasciando che i lettori indovinino la motivazione logica, e le congetture sono solitamente meno generose della verità.
Formati
Word per la stesura e la revisione, soprattutto laddove un esperto della materia debba verificarne l'accuratezza.
PDF per documenti di briefing, guide stampate e tutto ciò che viene distribuito anziché pubblicato.
PowerPoint quando la spiegazione viene presentata durante una sessione. La spiegazione dei concetti funziona bene dal vivo, perché puoi guardare i volti delle persone e adattarti, cosa che un documento non può fare.
Il tuo centro assistenza o la knowledge base per tutto ciò che è rivolto ai clienti, con link incrociati dagli articoli di guida pratica che fanno riferimento al concetto.
Testare una spiegazione
Più difficile da testare rispetto alle istruzioni, perché un lettore che ha capito male non ne è consapevole.
Il metodo che funziona: chiedi a qualcuno di rispiegartelo con parole sue. Non se ha capito (domanda a cui tutti rispondono di sì), ma chiedi proprio la spiegazione. I punti in cui la sua versione diverge dalla tua sono quelli in cui l'articolo ha fallito.
Ancora meglio, chiedi loro di prevedere qualcosa. "In base a quanto hai appena letto, cosa succederebbe se salvassi una modifica e generassi immediatamente un report?" Una previsione errata è un feedback preciso su quale parte non è stata recepita.
Fai il test con qualcuno che corrisponda al pubblico reale. Un collega che conosce già il concetto leggerà il tuo articolo e vi riconoscerà la verità, il che non ti dirà nulla di utile.
Manutenzione
Gli articoli concettuali invecchiano più lentamente delle guide pratiche, poiché i principi di base cambiano meno spesso delle interfacce.
Tuttavia, possono andare incontro a problemi in due modi specifici. Il sistema cambia e la spiegazione smette silenziosamente di essere vera (il che è peggio di uno screenshot obsoleto perché nulla sembra palesemente errato). Oppure una guida pratica correlata cambia, lasciando l'articolo concettuale a descrivere qualcosa che non corrisponde più alle istruzioni.
Rivedili annualmente e ogni volta che ciò che viene spiegato subisce modifiche. Indica la data dell'ultima revisione, poiché i lettori tendono comprensibilmente a sminuire le spiegazioni non datate di comportamenti tecnici.
Best practice
Un solo concetto per articolo.
Risposta breve in alto, fornita immediatamente.
Dichiara esplicitamente la credenza comune.
Esempio concreto prima del principio generale.
Al massimo un'analogia, con i suoi limiti ben dichiarati.
Eccezioni dopo l'idea principale, mai prima.
Un diagramma laddove il concetto sia strutturale.
Inserisci un link esterno anziché spiegare all'interno di una guida pratica.
Testa chiedendo a qualcuno di rispiegartelo.
Spiega cosa fare diversamente sapendo questo.
Errori comuni
Definizione all'inizio, esempio alla fine.
Ogni eccezione coperta, finendo per seppellire l'idea centrale.
La convinzione esistente del lettore non viene mai affrontata, quindi la correzione non viene recepita.
Scritto per qualcuno che capisce già l'argomento.
Un'analogia estesa oltre il punto in cui ha senso.
Concetto e istruzioni mescolati in un unico articolo.
Nessuna implicazione pratica, così il lettore impara qualcosa ma non se ne fa nulla.
Gergo definito utilizzando altro gergo.
Diagrammi con una propria terminologia indipendente.
Testato con colleghi che conoscevano già l'argomento.
Senza data, così i lettori non possono giudicare se sia ancora vero.
Alcune cose sono più facili da mostrare che da scrivere
Apri il modello in Trupeer AI, applica il tuo brand kit in modo che gli articoli corrispondano alla tua documentazione e modifica direttamente qualsiasi sezione. La configurazione si trova nella guida al modello.
La scrittura esplicativa è davvero difficile e alcuni concetti vi oppongono resistenza. Qualsiasi cosa sequenziale, qualsiasi cosa in cui il lettore abbia bisogno di vedere il cambiamento di stato e qualsiasi cosa che coinvolga un'interfaccia tende a richiedere quattro paragrafi per iscritto e trenta secondi per essere dimostrata.
Registra l'azione e Trupeer AI produrrà la spiegazione scritta e un video narrato dallo stesso passaggio, così l'articolo potrà contenere entrambi. I lettori che preferiscono il testo otterranno il testo, e quelli che hanno bisogno di vederlo potranno farlo. Traducilo in oltre 65 lingue e conserva il set nella tua knowledge base insieme agli articoli di guida pratica che vi rimandano.
Registralo. Personalizzalo con il tuo brand. Traducilo. Rendilo Trupeer.
Domande frequenti
Esiste un modello gratuito di articolo informativo in Word?
Sì. Word è il formato principale, con la struttura completa che include la risposta breve, la credenza comune e le sezioni di spiegazione. Download gratuito, nessuna registrazione, nessuna filigrana.
Esiste un modello di articolo in Word scaricabile gratuitamente?
Sì, e funziona per articoli esplicativi di qualsiasi tipo: cosa-è, come-funziona, perché, confronti e guide decisionali.
Esiste un modello di articolo gratuito?
Sì, in Word, PDF e PowerPoint, tutti gratuiti e senza necessità di creare un account. Se hai bisogno di istruzioni anziché di spiegazioni, il modello di articolo guida pratica è più adatto.
Esiste un modello gratuito di articolo informativo in PDF?
Sì, sia vuoto sia con un esempio compilato, il che è utile perché la differenza tra una spiegazione buona e una scarsa è più facile da vedere che da descrivere.
Esiste un modello gratuito di articolo informativo in PPT o PowerPoint?
Sì. La versione PowerPoint serve per spiegare un concetto durante una presentazione anziché in un documento, il che spesso funziona meglio poiché puoi osservare se le persone ti seguono e adattarti di conseguenza. Conserva la versione scritta come archivio.
Posso scaricare un modello gratuito di articolo informativo?
Sì, ogni formato è scaricabile gratuitamente senza alcun obbligo di attribuzione.
Qual è il miglior modello gratuito di articolo informativo?
Quello con una sezione per la risposta breve in alto e uno spazio per nominare il malinteso comune. La maggior parte dei modelli offre intestazioni per introduzione, corpo e conclusione, che è la struttura che rende le spiegazioni difficili da seguire. Rispondere immediatamente e affrontare ciò che il lettore già crede sono le due cose che migliorano maggiormente una spiegazione.
Cos'è un articolo informativo?
Un articolo che spiega qualcosa anziché fornire istruzioni a qualcuno. Risponde a cos'è una cosa, come funziona, perché funziona in quel modo o in cosa differiscono due cose. Si differenzia da un articolo di guida pratica (how-to), che illustra un'attività passo-passo, e dal materiale di riferimento, che elenca valori e opzioni.
Cosa dovrebbe includere un articolo informativo?
Un titolo espresso con le parole del lettore, una risposta breve di due o tre frasi, il motivo per cui è importante per lui, la credenza comune dichiarata esplicitamente, la spiegazione con un esempio concreto prima del principio generale, i casi limite successivamente, l'implicazione pratica e i link ai concetti correlati e a qualsiasi guida pratica pertinente.
Come si scrive una buona spiegazione?
Scopri cosa crede attualmente il lettore, di solito a partire dalle domande di supporto, e scrivi per scardinare questa convinzione anziché limitarti a esporre la verità. Metti l'esempio concreto prima del principio astratto. Dai subito la risposta breve. Usa al massimo un'analogia e dichiara dove si interrompe. Inserisci le eccezioni dopo l'idea principale, non prima.
Quanto deve essere lungo un articolo informativo?
Da ottocento a millecinquecento parole per la maggior parte dei concetti. Se è più lungo, di solito significa che stai coprendo diversi concetti o che hai incluso materiale di riferimento che appartiene ad un altro spazio. Il test consiste nel verificare se il lettore può prendere la decisione influenzata dall'articolo, non se viene coperto ogni singolo caso.
Qual è la differenza tra un articolo informativo e un articolo di guida pratica (how-to)?
Un articolo informativo spiega il "perché" o il "cosa". Un articolo di guida pratica spiega il "come", in passaggi numerati, per qualcuno che si trova a metà di un'attività. Mescolarli non serve a nessun lettore, poiché chi sta eseguendo un'operazione non vuole informazioni di contesto e chi sta imparando non vuole essere catapultato al passaggio quattro. Tienili separati e inserisci dei link tra di loro.
Come fai a sapere se una spiegazione ha funzionato?
Chiedi a qualcuno di rispiegartelo con parole sue o, meglio ancora, di prevedere cosa accadrebbe in una situazione specifica. Chiedere semplicemente se ha capito riceverà un sì in ogni caso. Fai il test con qualcuno del pubblico reale, poiché un collega che conosce già il concetto riconoscerà la verità nel tuo articolo senza imparare nulla da esso.
Ogni quanto tempo vanno rivisti gli articoli informativi?
Ogni anno e ogni volta che ciò che viene spiegato cambia. Invecchiano più lentamente rispetto agli articoli di guida pratica, ma diventano obsoleti in modo più silenzioso: uno screenshot non aggiornato è evidente, una spiegazione che non è più vera appare esattamente come una corretta.
Posso personalizzare questo modello di articolo informativo?
Sì, ogni versione è completamente modificabile. Le due sezioni che vale la pena mantenere sono la risposta breve in alto e la credenza comune, poiché sono ciò che distingue una spiegazione che le persone riescono a seguire da una che si limitano a leggere.
