Tone of Voice - Manuale FIRE
Principi Fondamentali
Partnership tecnica, non didattica Il lettore è un collaboratore esperto che necessita documentazione precisa, non un principiante da guidare per mano.
Diretto al punto Zero convenevoli, zero dichiarazioni di intenti. Ogni frase ha uno scopo tecnico o operativo.
Progressione: Cosa → Come → Perché serve Ogni concetto segue questa sequenza senza divagazioni.
Regole di Scrittura
1. Elimina il superfluo
❌ “Benvenuto nella guida. Il nostro obiettivo è fornirti una comprensione chiara…” ✅ “Questa guida documenta il sistema di forecasting di FIRE.”
❌ “In questa sezione esploreremo insieme…” ✅ “Il Forecast Lab valuta l’accuratezza del modello.”
2. Termini tecnici: spiega, non parafrasare
❌ “Il lookahead bias, ovvero quando il sistema ‘bara’…” ✅ “Lookahead Bias: Si verifica quando il sistema usa informazioni non disponibili al momento della decisione.”
Pattern: Termine in grassetto + definizione tecnica precisa, senza infantilizzare.
3. Metafore solo se accelerano la comprensione
✅ “L’analisi tecnica tradizionale è come guidare guardando lo specchietto retrovisore” ❌ “Il modello è come un amico fidato che ti consiglia…”
Criterio: La metafora funziona se il lettore capisce il concetto tecnico in 3 secondi anziché 30. Altrimenti, eliminarla.
4. Istruzioni operative: precise e sequenziali
❌ “Vai nelle impostazioni e configura l’indicatore”
✅ “1. Clicca 🔧 in alto a destra [IMG-042] 2. Seleziona ‘Indicatori Tecnici’ > ‘MACD’ 3. Imposta Periodo = 20, Deviazione = 2 4. Clicca ‘Applica’”
Pattern: Numeri, posizioni esatte, riferimenti visivi, conferma del risultato.
5. Evita il tono professorale
❌ “Come abbiamo visto…” / “Ricordiamo che…” / “È importante notare…” ✅ Dichiarazioni dirette senza meta-commenti sul processo di lettura.
❌ “Questo è un concetto avanzato, ma non preoccuparti…” ✅ Spiegazione tecnica diretta. Il lettore valuterà autonomamente la complessità.
6. Dati e metriche: sempre contestualizzati
❌ “Directional Accuracy: misura la percentuale di previsioni corrette”
✅ “Directional Accuracy: Percentuale di previsioni corrette sulla direzione.
- Valore > 50% = vantaggio sul caso
- Valore > 52% = edge sfruttabile
- Valore < 50% = peggio del caso”
Pattern: Definizione + soglie operative interpretabili.
7. Codice e pseudocodice preferiti a lunghe spiegazioni
❌ “La strategia compra quando il prezzo supera la media mobile e contemporaneamente il forecast è positivo”
✅
CONDIZIONI ACQUISTO:
- Prezzo > MA(50)
- Forecast(+5) > Prezzo corrente
8. Avvisi e note: funzionali, non allarmistici
❌ “Attenzione! Non fare mai questo errore!” ✅ ”💡 Nota operativa: Il lookahead bias invalida il backtest. Verificare sempre lo shift temporale.”
Icone:
- 💡 Nota operativa (best practice)
- ⚠️ Errore critico (causa fallimento)
- 📖 Rimando ad approfondimento
Struttura del Contenuto
Template Base
# Titolo Funzione/Concetto
[Definizione in 1 frase]
## Come Funziona
[Meccanica tecnica, step numerati se sequenziale]
## Interpretazione
[Come leggere output/grafico]
## Applicazioni Operative
[Casi d'uso concreti con esempi di codice]
## [Metriche/Parametri se rilevanti]
📖 Approfondimenti: [rimando se necessario]Lunghezza
- Paragrafi: Max 4-5 righe
- Frasi: Max 25-30 parole
- Liste: Preferite a prose lunghe
- Codice: Preferito a spiegazioni verbali quando possibile
Esempi Comparativi
Esempio 1: Spiegazione concetto
❌ Troppo colloquiale “Allora, il rolling forecast è un metodo molto interessante che ci permette di vedere come il modello si sarebbe comportato nel passato. Praticamente, facciamo tante piccole previsioni…”
✅ Tono corretto “Rolling Forecast: Backtest che simula l’uso del modello nel passato.
Processo:
- Prende N giorni di storia
- Prevede i successivi M giorni
- Confronta previsione vs realtà
- Avanza di M giorni, ripete
Output: Multiple linee di previsione sovrapposte ai prezzi reali [IMG-201].”
Esempio 2: Istruzione operativa
❌ Troppo vago “Per creare una strategia con forecast, devi integrare l’indicatore nella tua logica di trading e poi testarlo”
✅ Tono corretto “Integrazione forecast nella strategia:
# Esempio: Conferma predittiva per MACD
if macd_signal == 'BUY':
if forecast_5d > price_current:
execute_buy()Backtest confronta:
- Baseline: Strategia senza forecast
- Enhanced: Strategia con forecast
Se Sharpe Ratio non migliora di almeno 10-15%, il forecast non aggiunge valore.”
Esempio 3: Definizione tecnica
❌ Troppo semplificato “Il lookahead bias è quando ‘sbirci’ nel futuro durante il test”
❌ Troppo accademico “Il lookahead bias rappresenta una distorsione metodologica nella quale il processo di validazione retrospettiva incorpora elementi informativi temporalmente successivi…”
✅ Tono corretto “Lookahead Bias: Errore critico nel backtesting. Si verifica quando il sistema usa informazioni non disponibili al momento della decisione.
Causa: Mancato shift temporale delle previsioni. Effetto: Risultati falsamente ottimistici, irreplicabili in live trading. Prevenzione: Allineamento temporale corretto (shift).”
Checklist Revisione Testi
Prima di pubblicare, verificare:
- Nessun “Benvenuto”, “Il nostro obiettivo è”, “Esploreremo insieme”
- Ogni termine tecnico ha definizione alla prima occorrenza
- Istruzioni operative hanno: posizione esatta + [IMG-XXX] + step numerati
- Metriche hanno soglie interpretative (es. ”> 50% = buono”)
- Codice/pseudocodice usato dove possibile
- Paragrafi max 4-5 righe
- Nessuna metafora superflua (criterio: accelera comprensione in 3 sec?)
- Rimandi a Compendio solo dove necessario
- Tono: collaborativo-tecnico, non didattico
In Sintesi
Cosa siamo: Documentazione tecnica per operatori esperti che necessitano precisione e rapidità.
Cosa NON siamo:
- Tutorial per principianti
- Corso introduttivo con rassicurazioni
- Contenuto marketing con promesse
Il lettore ideale: Un trader/developer che conosce i fondamenti, cerca dettagli operativi precisi, e vuole implementare velocemente senza perdere tempo in convenevoli.