Cosa fa la Revisione documento
La Revisione documento esamina il tuo documento sotto diversi aspetti: Struttura e organizzazione:- Flusso logico e progressione
- Gerarchia e coerenza dei titoli
- Equilibrio e ritmo delle sezioni
- Architettura dell’informazione
- Complessità e lunghezza delle frasi
- Uso di gergo e linguaggio tecnico
- Transizioni tra i concetti
- Punteggio complessivo di leggibilità
- Contesto o informazioni di base mancanti
- Lacune nelle spiegazioni
- Domande senza risposta
- Aree che necessitano di approfondimento
- Coerenza del tono
- Problemi di formattazione
- Ridondanza e ripetizioni
- Opportunità di miglioramento
Come avviare la Revisione documento
L’Assistente leggerà l’intero documento e fornirà un feedback strutturato organizzato per categoria.
La Revisione documento funziona con tutti i modelli, ma Max fornisce il feedback più approfondito e sfumato, specialmente per documenti lunghi o complessi. Per controlli rapidi, Fast offre un buon equilibrio tra profondità e velocità.
Revisione documento vs. chat generale dell’Assistente
| Funzionalità | Revisione documento | Chat generale dell’Assistente |
|---|---|---|
| Scopo | Feedback strutturato sul documento | Conversazione aperta e attività |
| Ambito | Analisi dell’intero documento | Risponde a domande specifiche |
| Formato output | Organizzato per categorie di feedback | Risposte conversazionali |
| Profondità di analisi | Completa, multidimensionale | Focalizzata sulla tua domanda specifica |
| Ideale per | Controlli qualità, revisioni pre-pubblicazione | Modifiche rapide, riassunti, domande sui contenuti |
| Prompt di follow-up | Puoi fare domande di chiarimento | Conversazione continua |
| Consumo crediti | Più alto (analizza l’intero documento) | Varia in base alla complessità della richiesta |
Quando usare la Revisione documento
La Revisione documento è più utile in questi scenari:Prima della condivisione esterna
Revisiona presentazioni, proposte o documenti destinati ai clienti per individuare problemi strutturali, sezioni poco chiare o contesto mancante prima dell’invio.Controllo qualità
Esegui revisioni periodiche sulla documentazione importante, wiki del team o articoli della knowledge base per mantenere alta qualità e coerenza nel tempo.Miglioramento dei contenuti
Ottieni suggerimenti concreti per post del blog, report o testi di lunga durata. L’Assistente può identificare aree che necessitano di ampliamento, semplificazione o ristrutturazione.Preparazione alla collaborazione
Prima di condividere con i colleghi, assicurati che il documento sia chiaro, completo e ben organizzato. Questo riduce gli scambi e migliora l’efficienza della collaborazione.Apprendimento e sviluppo delle competenze
Usa le revisioni per comprendere i pattern nella tua scrittura: problemi ricorrenti di chiarezza, tendenze strutturali o aree in cui hai costantemente bisogno di migliorare.Puoi eseguire la Revisione documento più volte. Apporta modifiche in base al feedback, poi revisiona nuovamente per verificare se i problemi sono stati risolti. Questo approccio iterativo ti aiuta a capire cosa funziona e a perfezionare progressivamente i tuoi contenuti.
Interpretare il feedback
Il feedback della Revisione documento è organizzato in categorie chiare. Ecco come interpretarlo e metterlo in pratica:Feedback sulla struttura
Cosa ti dice: Quanto il contenuto scorre bene, se le sezioni sono equilibrate e se l’architettura dell’informazione ha senso. Esempi di feedback:- “L’introduzione è troppo lunga rispetto al resto del documento”
- “La Sezione 3 manca di una transizione chiara dalla Sezione 2”
- “La gerarchia dei titoli salta da H2 a H4”
Feedback sulla chiarezza
Cosa ti dice: Se la tua scrittura è facile da comprendere, se le frasi sono troppo complesse e dove i lettori potrebbero confondersi. Esempi di feedback:- “Questo paragrafo usa pesantemente la forma passiva, rendendolo più difficile da seguire”
- “Il gergo tecnico nella prima sezione potrebbe confondere i lettori non esperti”
- “La lunghezza media delle frasi è di 35 parole: considera di suddividerle in frasi più brevi”
Feedback sulla completezza
Cosa ti dice: Lacune nei tuoi contenuti: contesto mancante, domande senza risposta o aree che necessitano di maggiori dettagli. Esempi di feedback:- “Il documento menziona ‘il nuovo processo’ ma non lo definisce mai”
- “I passaggi 2 e 3 presuppongono conoscenze pregresse non trattate nell’introduzione”
- “Non sono presenti conclusioni o prossimi passi”
Feedback sulla qualità
Cosa ti dice: Coerenza del tono, problemi di formattazione e opportunità per perfezionare i tuoi contenuti. Esempi di feedback:- “Il tono passa da formale a informale tra le sezioni”
- “I punti elenco hanno una formattazione incoerente (alcuni terminano con il punto, altri no)”
- “Questo concetto è spiegato due volte: considera di accorpare”
Consumo di crediti
La Revisione documento consuma crediti AI in base alla lunghezza e complessità del documento:| Lunghezza documento | Costo approssimativo (Fast) | Costo approssimativo (Max) |
|---|---|---|
| Breve (< 500 parole) | ~0,5 crediti | ~1-2 crediti |
| Medio (500-2000 parole) | ~1-2 crediti | ~3-5 crediti |
| Lungo (2000-5000 parole) | ~2-4 crediti | ~6-10 crediti |
| Molto lungo (5000+ parole) | ~5+ crediti | ~12+ crediti |
Queste sono stime basate su documenti tipici. Il consumo effettivo dipende dalla struttura del documento, dalla complessità della formattazione e dal modello scelto. Controlla il saldo crediti nel menu dell’Assistente.
Consigli per revisioni migliori
1. Prepara prima il documento Assicurati che il documento sia ragionevolmente completo prima di avviare una revisione. L’Assistente fornisce un feedback migliore su bozze finite che su schemi approssimativi. 2. Specifica il tuo pubblico In un prompt successivo, indica all’Assistente a chi è destinato il documento:- “Questo è per un team tecnico che conosce il prodotto”
- “Il pubblico è composto da stakeholder non tecnici”
- “Scritto per nuovi utenti che non hanno mai usato Craft”
- “Quali 3 problemi dovrei risolvere per primi?”
- “Qual è il problema strutturale più critico?”
- “Concentrati solo sui problemi di chiarezza”
- “Revisiona per la coerenza del tono”
- “Controlla solo la completezza e il contesto mancante”
- “Concentrati sulla struttura per un pubblico principiante”
- On-device: Non consigliato per la Revisione documento (contesto limitato)
- Core: Controlli strutturali rapidi su documenti brevi
- Fast: Buon equilibrio per la maggior parte delle revisioni (500-2000 parole)
- Max: Ideale per documenti lunghi e complessi o quando hai bisogno del feedback più approfondito
Esempio: Prima di pubblicare un post del blog
Sara scrive un post del blog sull’uso delle Collezioni in Craft. Prima di pubblicare, vuole assicurarsi che sia chiaro e completo.L’Assistente analizza il documento e fornisce il feedback:
- Struttura: “L’introduzione è efficace, ma la Sezione 2 è lunga il doppio delle Sezioni 3 e 4 messe insieme. Considera di dividerla in due parti.”
- Chiarezza: “Diversi termini tecnici (relazioni, proprietà, viste) sono usati prima di essere definiti. Aggiungi un glossario o definiscili al primo utilizzo.”
- Completezza: “Il post spiega cosa sono le Collezioni ma non tratta quando usarle rispetto a cartelle o tag.”
- Qualità: “Il tono è coerente. Una sezione ridondante alla fine ripete l’introduzione: considera di rimuoverla.”
Sara apporta modifiche in base al feedback: divide la Sezione 2, aggiunge definizioni, include una sezione “Quando usare le Collezioni” e rimuove le ridondanze.
Limitazioni
La Revisione documento fornisce feedback ma non applica le modifiche direttamente. Per mettere in pratica i suggerimenti, passa alla modalità Execute con un modello Fast o Max e chiedi all’Assistente di implementare le modifiche consigliate. Consulta Modificare con Craft Assistant. Per documenti molto brevi (meno di 200 parole), la Revisione documento potrebbe non offrire molto valore: la chat generale dell’Assistente è spesso più appropriata per attività rapide.Articoli correlati
Usare Craft Assistant
Scopri come lavorare con l’Assistente e avviare conversazioni
Scegliere i modelli AI
Seleziona il modello giusto per la Revisione documento e altre attività
Modificare con Craft Assistant
Applica i suggerimenti della revisione direttamente in modalità Execute
Prompt personalizzati
Crea istruzioni di revisione riutilizzabili per un feedback coerente
Crediti
Scopri il consumo di crediti per la Revisione documento e altre funzionalità