Guida
Scrivere un manuale professionale che il lettore può usare
Un manuale non è una raccolta di conoscenze: è un percorso con decisioni, esempi e controlli.
In breve
Per scrivere un manuale professionale definisci lettore, problema di lavoro, risultato osservabile, metodo, prove ed esempi. Ordina i capitoli in base alle decisioni che il lettore deve prendere, non solo alle competenze dell'autore.
Quando serve
Per scrivere un manuale professionale definisci lettore, problema di lavoro, risultato osservabile, metodo, prove ed esempi. Ordina i capitoli in base alle decisioni che il lettore deve prendere, non solo alle competenze dell'autore.
Metodo passo per passo
Intervista il risultato, raccogli casi sintetici, costruisci l'outline, prova un capitolo operativo e inserisci checklist alla fine di ogni unità.
Dove serve giudizio umano
L'esperto deve validare accuratezza, contesto e limiti del metodo; l'AI non crea prova professionale dal nulla.
Errore da evitare
Usare il gergo come sostituto di esempi rende il manuale difficile da applicare.
Strumenti operativi
ESEMPIO: procedura
Input: Manuale per impostare un processo di onboarding
Decisione: mostrare input, passaggi e controllo
Risultato: il lettore può eseguire una prova
- Lettore
- Problema
- Risultato
- Metodo
- Esempi
- Verifica