Scrittura al contrario: scrivete prima il testo, il markup per ultimo
Quasi tutti partono da frammenti {a|b|c}, sperando che una pila di sinonimi diventi un articolo. Quella strada crolla nel momento in cui entrano in gioco la grammatica, i dati specifici di ogni sito o un vero filo narrativo. La soluzione è un semplice cambio di direzione.
Il modello mentale
Il parser e chi scrive lavorano in direzioni opposte.
- Il parser espande la sintassi dall’interno verso l’esterno. Prima si risolvono le enumerazioni interne, poi quelle esterne, poi le permutazioni e infine la sostituzione delle variabili.
- Chi scrive progetta il template partendo dalla frase già risolta e leggibile e andando a ritroso fino alla sintassi.
Non state generando varianti. State vincolando un articolo pulito finché non diventa qualcosa che il motore può rigenerare mille volte senza rompere la grammatica.
Il cambiamento è tutto qui:
frase finale leggibile
→ legare la grammatica
→ scegliere confini di ramo sicuri
→ estrarre le variabili
→ aggiungere variazione strutturale
→ aggiungere i sinonimi locali per ultimiLa sinonimizzazione è l’ultima rifinitura, non il primo passo.
Il flusso al contrario in cinque passi
- Scrivete la frase finale in lingua normale. Niente graffe, niente quadre, niente variabili. Solo la frase che volete far leggere a qualcuno.
- Segnate la grammatica che deve restare legata. Soggetto e verbo. Preposizione e termine retto. Articolo e sintagma nominale. Accordo di nome e aggettivo. Nessuna di queste cose può essere spezzata da un confine di ramo.
- Scegliete confini di ramo sicuri. Un confine sta tra unità grammaticali, mai dentro una di esse.
- Estraete in variabili i fatti ripetuti o specifici di un sito. Tutto ciò che cambia per sito, per prodotto o per articolo va in
%NomeVariabile%. - Prima la variazione strutturale, i sinonimi locali per ultimi. Permutazioni e frammenti opzionali creano varietà vera. I sinonimi sono una piccola rifinitura finale dentro spazi grammaticali già sicuri.
La prova pratica prima di ogni {a|b} che scrivete:
Se sostituisco solo questo frammento, restano corretti caso, accordo, reggenza, articoli e ordine delle parole?
Se la risposta non è un sì immediato, legate una frase più lunga dentro un unico ramo.
Fase 0 — Scrivete prima un articolo leggibile
Il testo di partenza è prima di tutto un articolo, e solo dopo un input per spintax. La leggibilità batte sempre la comodità del template.
Passo 1. Scrivete un articolo normale
Scrivete un articolo pulito e leggibile come se non dovesse mai diventare un template. Con introduzioni, transizioni, contesto, spiegazioni — tutto quello che serve a un buon articolo. La vostra voce. I vostri ganci. Un filo vero tra le sezioni.
Non ottimizzate per spintax in questa fase. State scrivendo per una sola persona. Il template viene dopo.
Passo 2. Individua le zone templatizzabili
Non tutti i paragrafi devono variare. Rileggete il testo finito e segnate le zone precise che si prestano:
- Elenchi di fatti (funzioni, casi d’uso, integrazioni supportate) — gli elementi si possono mescolare e usare in sottoinsiemi.
- Descrizioni parallele (livelli di piano, capacità della piattaforma) — elementi con struttura simile si possono riordinare.
- Frasi di apertura delle sezioni — quasi sempre ammettono due o tre formulazioni alternative.
- Dati concreti che cambiano da sito a sito — diventano variabili.
Il resto lasciatelo com’è. Introduzioni, transizioni, testo esplicativo e filo narrativo si leggono quasi sempre meglio fissi. Templatizzarli aggiunge complessità e porta poco valore reale contro l’impronta.
Un articolo tipico finisce intorno al 60-70 % di testo fisso leggibile e al 30-40 % di zone templatizzabili. Quel rapporto è il segno di un template sano.
Passo 3. Prepara le zone templatizzabili
Solo dentro le zone segnate, applicate questi principi di scrittura:
- Indipendenza di ogni frase. Ogni frase di una zona permutabile deve reggersi da sola. Niente «Ecco perché…», «Di conseguenza…» o «Come detto sopra…»: si rompono appena l’ordine cambia.
- Elementi di elenco paralleli. Gli elementi destinati alla permutazione seguono lo stesso schema grammaticale — stessa struttura, stessa forma di frase. Elementi paralleli sono intercambiabili, ed è esattamente ciò che serve alle permutazioni.
- Un’idea per frase. Separate le idee in frasi distinte. Ognuna diventa un elemento della permutazione.
- Concreto invece che vago. I fatti precisi producono variazione migliore degli aggettivi generici. «Le richieste si concludono in meno di 100 ms» rende più di «È veloce».
Regole generali dell’articolo
Valgono in tutto l’articolo, non solo nelle zone templatizzabili.
- Dove sta il marchio. Citate il marchio presto, poi usate richiami generici («la piattaforma», «il prodotto»). L’articolo intero deve leggersi naturale senza il nome del marchio in ogni paragrafo.
- Evitate le istruzioni che scadono. Non scrivete guide passo-passo per interfacce di terzi (wallet, pannelli, integrazioni esterne). Cambiano spesso e il vostro template invecchia con loro. Descrivete in una o due frasi che cosa fa lo strumento.
- Lunghezza delle sezioni. Sezioni
<h2>: 100–250 parole. Sezioni<h3>: 50–150 parole. Se una sezione supera le ~300 parole, dividetela. - Niente riempitivi né meta-commenti. Togliete le frasi che parlano del testo invece di informare: «Diamo un’occhiata a…», «Vale la pena notare che…», «In questa sezione spiegheremo…».
Errori frequenti in fase di scrittura
| Da evitare | Perché | Da fare invece |
|---|---|---|
Partire da frammenti {a|b|c} |
State risolvendo il rompicapo sintattico prima che il contenuto esista. | Scrivete prima un articolo normale. La sintassi alla fine. |
| Templatizzare ogni paragrafo | Distrugge la leggibilità senza aggiungere varietà. | Templatizzate il ~30–40 % delle zone. La narrazione resta fissa. |
| Permutare frasi narrative | «Come abbiamo visto sopra…» si rompe quando l’ordine cambia. | Tenete fissa la narrazione. Permutate solo fatti indipendenti. |
| Scrivere i sinonimi prima della struttura | Bloccate la grammatica prima di aver pensato alla forma. | Prima la struttura (permutazioni, variabili), i sinonimi per ultimi. |
| Infilare tre idee in una frase e poi provare a permutarla | Gli elementi si sovrappongono e il riordino produce nonsense. | Un’idea per frase dentro le zone permutabili. |
Checklist del testo di partenza
Prima di passare al markup, verificate:
- L’articolo si legge bene come pagina autonoma.
- Le zone templatizzabili sono individuate — non l’intero testo.
- Le frasi in quelle zone si reggono da sole.
- Gli elementi di elenco in quelle zone sono paralleli.
- Il marchio è citato con parsimonia.
- Nessuna guida passo-passo per interfacce di terzi.
- Niente riempitivi né meta-commenti.
- Ogni sezione
<h2>e<h3>rientra nei limiti di lunghezza.
Se tutte le caselle sono spuntate, il testo di partenza è pronto. Le tre guide successive lo trasformano in un template: variabili, permutazioni e sinonimizzazione senza rompere la grammatica — in quest’ordine.