La Revisione documento fornisce feedback strutturato e pratico sulla tua scrittura. Invece di porre domande generali all’Assistant, la Revisione documento analizza l’intero documento e offre indicazioni su struttura, chiarezza, completezza e qualità complessiva. Questo ti aiuta a individuare i problemi prima di condividere, migliorare la qualità dei contenuti e ottenere una prospettiva esterna sul tuo lavoro – tutto senza uscire da Craft.Documentation Index
Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Cosa fa la Revisione documento
La Revisione documento esamina il tuo documento su più dimensioni: Struttura e organizzazione:- Flusso logico e progressione
- Gerarchia e coerenza dei titoli
- Bilanciamento delle sezioni e ritmo
- Architettura delle informazioni
- Complessità e lunghezza delle frasi
- Uso di gergo e linguaggio tecnico
- Transizioni tra le idee
- Punteggio di leggibilità complessivo
- Contesto o background mancante
- Lacune nelle spiegazioni
- Domande senza risposta
- Aree che necessitano di espansione
- Coerenza del tono
- Problemi di formattazione
- Ridondanze e ripetizioni
- Opportunità di miglioramento
Come avviare la Revisione documento
L’Assistant leggerà l’intero documento e fornirà 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 con l’Assistant
| Funzionalità | Revisione documento | Chat generale con l’Assistant |
|---|---|---|
| Scopo | Feedback strutturato sul documento | Conversazione e attività a risposta aperta |
| Ambito | Analisi dell’intero documento | Risponde a domande specifiche |
| Formato output | Organizzato per categorie di feedback | Risposte conversazionali |
| Profondità analisi | Completa, multidimensionale | Focalizzata sulla tua domanda specifica |
| Ideale per | Controlli di qualità, revisioni pre-pubblicazione | Modifiche rapide, riepiloghi, query sui contenuti |
| Domande di follow-up | Puoi fare domande di chiarimento | Conversazione continua |
| Utilizzo | Maggiore (analizza il documento completo) | Varia in base alla complessità della query |
Quando usare la Revisione documento
La Revisione documento è più utile in questi scenari:Prima di condividere esternamente
Rivedi presentazioni, proposte o documenti rivolti ai clienti per individuare problemi strutturali, sezioni poco chiare o contesto mancante prima di inviarli.Controllo di qualità
Esegui revisioni periodiche su documentazione importante, wiki di team o articoli di knowledge base per mantenere alta la qualità e la coerenza nel tempo.Miglioramento dei contenuti
Ottieni suggerimenti pratici per post del blog, rapporti o testi di lunga forma. L’Assistant può identificare le aree che necessitano di espansione, semplificazione o ristrutturazione.Preparazione alla collaborazione
Prima di condividere con i colleghi, assicurati che il documento sia chiaro, completo e ben organizzato. Questo riduce i botta e risposta 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 rivedi di nuovo per vedere se i problemi sono risolti. Questo approccio iterativo ti aiuta a capire cosa funziona e a perfezionare progressivamente i tuoi contenuti.
Comprendere il feedback
Il feedback della Revisione documento è organizzato in categorie chiare. Ecco come interpretarlo e come agire:Feedback sulla struttura
Cosa ti dice: Quanto scorre bene il tuo contenuto, se le sezioni sono bilanciate e se l’architettura delle informazioni ha senso. Esempio 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 capire, se le frasi sono troppo complesse e dove i lettori potrebbero confondersi. Esempio di feedback:- “Questo paragrafo usa molto la forma passiva, rendendolo 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 spezzarle in frasi più brevi”
Feedback sulla completezza
Cosa ti dice: Lacune nei tuoi contenuti – contesto mancante, domande senza risposta o aree che necessitano di più dettagli. Esempio di feedback:- “Il documento menziona ‘il nuovo processo’ ma non lo definisce mai”
- “I passi 2 e 3 presuppongono conoscenze pregresse non trattate nell’introduzione”
- “Non è presente una conclusione o i prossimi passi”
Feedback sulla qualità
Cosa ti dice: Coerenza del tono, problemi di formattazione e opportunità per raffinare i tuoi contenuti. Esempio di feedback:- “Il tono cambia da formale a informale tra le sezioni”
- “I punti elenco hanno una formattazione incoerente (alcuni terminano con il punto, altri no)”
- “Questo concetto viene spiegato due volte – considera di consolidarlo”
Utilizzo
La Revisione documento consuma più quota AI rispetto a una semplice domanda perché analizza l’intero documento in un unico passaggio. Documenti più lunghi e complessi consumano di più. Usa Fast per revisioni più rapide e leggere.L’utilizzo effettivo dipende dalla lunghezza del documento, dalla struttura, dalla complessità della formattazione e dal modello scelto. Controlla il tuo utilizzo nel menu dell’Assistant sotto Utilizzo e limiti.
Consigli per revisioni migliori
1. Prepara prima il documento Assicurati che il documento sia ragionevolmente completo prima di eseguire una revisione. L’Assistant fornisce un feedback migliore su bozze finite piuttosto che su schemi approssimativi. 2. Specifica il tuo pubblico In un prompt di follow-up, indica all’Assistant 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 devo risolvere per primi?”
- “Qual è il problema strutturale più critico?”
- “Concentrati solo sui problemi di chiarezza”
- “Rivedi questo per la coerenza del tono”
- “Controlla solo la completezza e il contesto mancante”
- “Concentrati sul fatto che la struttura abbia senso 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 pubblicarlo, vuole assicurarsi che sia chiaro e completo.L’Assistant analizza il documento e fornisce feedback:
- Struttura: “L’introduzione è solida, ma la Sezione 2 è due volte più lunga delle Sezioni 3 e 4 messe insieme. Considera di dividerla in due parti.”
- Chiarezza: “Diversi termini tecnici (relazioni, proprietà, viste) vengono 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 riprende 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 agire sui suggerimenti, passa alla modalità Esegui con un modello Fast o Max e chiedi all’Assistant di implementare le modifiche raccomandate. Consulta Modifica con Craft Assistant. Per documenti molto brevi (meno di 200 parole), la Revisione documento potrebbe non fornire molto valore – la chat generale con l’Assistant è spesso più appropriata per attività rapide.Articoli correlati
Usare Craft Assistant
Scopri come lavorare con l’Assistant e avviare conversazioni
Scegliere i modelli AI
Seleziona il modello giusto per la Revisione documento e altre attività
Modifica con Craft Assistant
Applica i suggerimenti della revisione direttamente in modalità Esegui
Prompt personalizzati
Crea istruzioni di revisione riutilizzabili per feedback coerenti
Utilizzo e limiti
Scopri l’utilizzo AI per la Revisione documento e altre funzionalità