Cosa fa Document Review
Document Review esamina il tuo Documento su più dimensioni: Struttura e organizzazione:- Flusso e progressione logica
- Gerarchia e coerenza delle intestazioni
- Bilanciamento e ritmo delle sezioni
- Architettura dell’informazione
- Complessità e lunghezza delle frasi
- Uso di gergo e linguaggio tecnico
- Transizioni tra le idee
- Punteggio complessivo di leggibilità
- Contesto o background mancanti
- Lacune nelle spiegazioni
- Domande senza risposta
- Aree che richiedono approfondimento
- Coerenza del tono
- Problemi di formattazione
- Ridondanza e ripetizioni
- Opportunità di miglioramento
Come avviare Document Review
Il Assistant leggerà l’intero Documento e fornirà feedback strutturato organizzato per categoria.
Document Review funziona con tutti i modelli, ma Max offre il feedback più approfondito e sfumato, soprattutto per Documenti più lunghi o complessi. Per controlli rapidi, Fast rappresenta un buon equilibrio tra profondità e velocità.
Document Review vs. chat generica con l’Assistant
| Feature | Document Review | General Assistant Chat |
|---|---|---|
| Scopo | Feedback strutturato sul Documento | Conversazione aperta e attività varie |
| Ambito | Analisi dell’intero Documento | Risposte a domande specifiche |
| Formato output | Organizzato per categorie di feedback | Risposte conversazionali |
| Profondità analisi | Completa, multidimensionale | Focalizzata sulla tua domanda specifica |
| Ideale per | Controlli qualità, revisioni pre-pubblicazione | Modifiche rapide, riepiloghi, domande sui contenuti |
| Prompt di follow-up | Puoi fare domande chiarificatrici | Conversazione continua |
| Uso crediti | Più elevato (analizza l’intero Documento) | Varia in base alla complessità della query |
Quando usare Document Review
Document Review è particolarmente utile nei seguenti scenari:Prima della condivisione esterna
Revisiona presentazioni, proposte o Documenti destinati a clienti per individuare problemi di struttura, sezioni poco chiare o contesto mancante prima di inviarli.Controllo qualità
Esegui revisioni periodiche su documentazione importante, wiki di team o articoli della knowledge base per mantenere alta la qualità e la coerenza nel tempo.Miglioramento dei contenuti
Ricevi suggerimenti azionabili per post sul blog, report o scritti long-form. L’Assistant può identificare parti da ampliare, semplificare o ristrutturare.Preparazione alla collaborazione
Prima di condividerlo con i colleghi, assicurati che il Documento sia chiaro, completo e ben organizzato. Questo riduce i rimbalzi e migliora l’efficienza della collaborazione.Apprendimento e sviluppo delle competenze
Usa le revisioni per comprendere i pattern della tua scrittura – problemi di chiarezza ricorrenti, tendenze strutturali o aree in cui devi migliorare.Puoi eseguire Document Review più volte. Applica le modifiche basate sul feedback e poi riesegui la revisione per verificare che i problemi siano risolti. Questo approccio iterativo ti aiuta a capire cosa funziona e a perfezionare progressivamente i contenuti.
Come interpretare il feedback
Il feedback di Document Review è organizzato in categorie chiare. Ecco come interpretarlo e agire:Feedback sulla struttura
Cosa indica: Quanto scorre il contenuto, se le sezioni sono bilanciate e se l’architettura dell’informazione ha senso. Esempi di feedback:- “L’introduzione è troppo lunga rispetto al resto del Documento”
- “La Sezione 3 non ha una transizione chiara dalla Sezione 2”
- “La gerarchia delle intestazioni salta da H2 a H4”
Feedback sulla chiarezza
Cosa indica: Se la tua scrittura è facile da capire, se le frasi sono troppo complesse e dove i lettori potrebbero confondersi. Esempi di feedback:- “Questo paragrafo usa la voce passiva in modo intenso, rendendolo più difficile da seguire”
- “Gergo tecnico nella prima sezione può confondere lettori non esperti”
- “La lunghezza media delle frasi è di 35 parole – considera di spezzarle”
Feedback sulla completezza
Cosa indica: Lacune nel contenuto – contesto mancante, domande non risposte o parti che necessitano maggiore dettaglio. Esempi di feedback:- “Il Documento menziona ‘il nuovo processo’ ma non lo definisce”
- “I passaggi 2 e 3 presumono conoscenze pregresse non coperte nell’introduzione”
- “Manca una conclusione o i prossimi passi”
Feedback sulla qualità
Cosa indica: Coerenza del tono, problemi di formattazione e opportunità per rifinire il contenuto. Esempi di feedback:- “Il tono passa da formale a informale tra le sezioni”
- “I punti elenco sono formattati in modo incoerente (alcuni terminano con punto, altri no)”
- “Un concetto è spiegato due volte – valuta di consolidare”
Uso dei crediti
Document Review consuma crediti Assistente IA in base alla lunghezza e alla complessità del Documento:| Lunghezza del Documento | Costo appross. in crediti (Fast) | Costo appross. in crediti (Max) |
|---|---|---|
| Corto (< 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. L’effettivo consumo dipende dalla struttura del Documento, dalla complessità della formattazione e dal modello scelto. Controlla il saldo dei crediti nel menu dell’Assistant.
Suggerimenti per revisioni migliori
1. Prepara prima il tuo Documento Assicurati che il tuo Documento sia ragionevolmente completo prima di eseguire una revisione. L’Assistant fornisce feedback migliori su bozze finite rispetto a semplici scalette. 2. Specifica il tuo pubblico In un prompt di follow-up, indica all’Assistant a chi è rivolto il Documento:- “Questo è per un team tecnico che conosce il prodotto”
- “Il pubblico è composto da stakeholder non tecnici”
- “Scritto per utenti nuovi che non hanno mai usato Craft”
- “Quali 3 problemi dovrei risolvere prima?”
- “Qual è il problema strutturale più critico?”
- “Concentrati solo sui problemi di chiarezza”
- “Controlla la coerenza del tono”
- “Verifica solo completezza e contesto mancante”
- “Concentrati sul fatto che la struttura abbia senso per un pubblico principiante”
- On-device – Non raccomandato per Document Review (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 serve il feedback più approfondito
Esempio: Prima di pubblicare un post sul blog
Sarah scrive un post sul blog sull’uso delle Collezioni in Craft. Prima di pubblicare, vuole assicurarsi che sia chiaro e completo.L’Assistant analizza il Documento e fornisce feedback:
- Struttura: “L’introduzione è efficace, ma la Sezione 2 è lunga il doppio delle Sezioni 3 e 4 messe insieme. Valuta di dividerla in due parti.”
- Chiarezza: “Diversi termini tecnici (relations, properties, views) sono usati prima di essere definiti. Aggiungi un glossario o definiscili al primo uso.”
- Completezza: “Il post spiega cosa sono le Collezioni ma non copre quando usarle rispetto a cartelle o tag.”
- Qualità: “Il tono è coerente. C’è una sezione ridondante alla fine che ripete l’introduzione – valuta di rimuoverla.”
Sarah apporta modifiche basate sul feedback: divide la Sezione 2, aggiunge definizioni, include una sezione “Quando usare le Collezioni” e rimuove la ridondanza.