Ce que fait la Revue de document
La Revue de document examine votre document selon plusieurs dimensions : Structure et organisation :- Flux logique et progression
- Hiérarchie et cohérence des titres
- Équilibre et rythme des sections
- Architecture de l’information
- Complexité et longueur des phrases
- Utilisation du jargon et du langage technique
- Transitions entre les idées
- Score global de lisibilité
- Contexte ou informations manquants
- Lacunes dans les explications
- Questions sans réponse
- Zones nécessitant un développement
- Cohérence du ton
- Problèmes de mise en forme
- Redondance et répétitions
- Opportunités d’amélioration
Comment lancer une Revue de document
L’Assistant parcourra l’intégralité de votre document et fournira des retours structurés organisés par catégorie.
La Revue de document fonctionne avec tous les modèles, mais Max fournit les retours les plus approfondis et nuancés, en particulier pour les documents plus longs ou plus complexes. Pour des vérifications rapides, Fast offre un bon équilibre entre profondeur et rapidité.
Revue de document vs. chat général de l’Assistant
| Caractéristique | Revue de document | Chat général de l’Assistant |
|---|---|---|
| Objectif | Retours structurés sur le document | Conversation ouverte et tâches |
| Portée | Analyse du document entier | Répond à des questions spécifiques |
| Format de sortie | Organisé par catégories de retours | Réponses conversationnelles |
| Profondeur d’analyse | Complète, multidimensionnelle | Centrée sur votre question spécifique |
| Idéal pour | Contrôles qualité, revues avant publication | Modifications rapides, résumés, requêtes de contenu |
| Prompts de suivi | Questions de clarification possibles | Conversation continue |
| Utilisation crédits | Plus élevée (analyse le document entier) | Varie selon la complexité de la requête |
Quand utiliser la Revue de document
La Revue de document est particulièrement utile dans ces situations :Avant un partage externe
Examinez les présentations, propositions ou documents destinés aux clients pour détecter les problèmes de structure, les sections confuses ou le contexte manquant avant de les envoyer.Assurance qualité
Effectuez des revues périodiques de la documentation importante, des wikis d’équipe ou des articles de base de connaissances pour maintenir une qualité et une cohérence élevées dans le temps.Amélioration du contenu
Obtenez des suggestions exploitables pour les articles de blog, rapports ou textes longs. L’Assistant peut identifier les zones nécessitant un développement, une simplification ou une restructuration.Préparation à la collaboration
Avant de partager avec vos collègues, assurez-vous que votre document est clair, complet et bien organisé. Cela réduit les allers-retours et améliore l’efficacité de la collaboration.Apprentissage et développement des compétences
Utilisez les revues pour comprendre les schémas de votre écriture : problèmes de clarté récurrents, tendances structurelles ou domaines dans lesquels vous devez constamment vous améliorer.Vous pouvez lancer la Revue de document plusieurs fois. Apportez des modifications en fonction des retours, puis relancez une revue pour vérifier si les problèmes sont résolus. Cette approche itérative vous aide à comprendre ce qui fonctionne et à affiner progressivement votre contenu.
Comprendre les retours
Les retours de la Revue de document sont organisés en catégories claires. Voici comment les interpréter et les exploiter :Retours sur la structure
Ce qu’ils vous indiquent : La fluidité de votre contenu, l’équilibre des sections et la pertinence de l’architecture de l’information. Exemples de retours :- “L’introduction est trop longue par rapport au reste du document”
- “La section 3 manque d’une transition claire depuis la section 2”
- “La hiérarchie des titres saute de H2 à H4”
Retours sur la clarté
Ce qu’ils vous indiquent : Si votre texte est facile à comprendre, si les phrases sont trop complexes et où les lecteurs pourraient se perdre. Exemples de retours :- “Ce paragraphe utilise beaucoup la voix passive, ce qui rend la lecture plus difficile”
- “Le jargon technique dans la première section peut dérouter les lecteurs non experts”
- “La longueur moyenne des phrases est de 35 mots : envisagez de les raccourcir”
Retours sur l’exhaustivité
Ce qu’ils vous indiquent : Les lacunes de votre contenu : contexte manquant, questions sans réponse ou zones nécessitant plus de détails. Exemples de retours :- “Le document mentionne ‘le nouveau processus’ mais ne le définit jamais”
- “Les étapes 2 et 3 présupposent des connaissances préalables non couvertes dans l’introduction”
- “Aucune conclusion ni prochaines étapes fournies”
Retours sur la qualité
Ce qu’ils vous indiquent : La cohérence du ton, les problèmes de mise en forme et les opportunités pour peaufiner votre contenu. Exemples de retours :- “Le ton passe de formel à familier entre les sections”
- “Les puces sont formatées de manière incohérente (certaines se terminent par un point, d’autres non)”
- “Ce concept est expliqué deux fois : envisagez de consolider”
Utilisation des crédits
La Revue de document consomme des crédits IA en fonction de la longueur et de la complexité de votre document :| Longueur du document | Coût approx. (Fast) | Coût approx. (Max) |
|---|---|---|
| Court (< 500 mots) | ~0,5 crédit | ~1-2 crédits |
| Moyen (500-2000 mots) | ~1-2 crédits | ~3-5 crédits |
| Long (2000-5000 mots) | ~2-4 crédits | ~6-10 crédits |
| Très long (5000+ mots) | ~5+ crédits | ~12+ crédits |
Ce sont des estimations basées sur des documents typiques. L’utilisation réelle dépend de la structure du document, de la complexité de la mise en forme et du modèle choisi. Vérifiez votre solde de crédits dans le menu de l’Assistant.
Conseils pour de meilleures revues
1. Préparez votre document d’abord Assurez-vous que votre document est raisonnablement complet avant de lancer une revue. L’Assistant fournit de meilleurs retours sur des brouillons aboutis que sur des ébauches sommaires. 2. Précisez votre audience Dans un prompt de suivi, indiquez à l’Assistant à qui le document est destiné :- “C’est pour une équipe technique familière avec le produit”
- “L’audience est composée de parties prenantes non techniques”
- “Écrit pour de nouveaux utilisateurs qui n’ont jamais utilisé Craft”
- “Quels sont les 3 problèmes que je devrais corriger en premier ?”
- “Quel est le problème structurel le plus critique ?”
- “Concentre-toi uniquement sur les problèmes de clarté”
- “Examine ceci pour la cohérence du ton”
- “Vérifie uniquement l’exhaustivité et le contexte manquant”
- “Concentre-toi sur la pertinence de la structure pour un public débutant”
- On-device : Non recommandé pour la Revue de document (contexte limité)
- Core : Vérifications structurelles rapides sur des documents courts
- Fast : Bon équilibre pour la plupart des revues (500-2000 mots)
- Max : Idéal pour les documents longs et complexes ou lorsque vous avez besoin des retours les plus approfondis
Exemple : Avant de publier un article de blog
Sarah rédige un article de blog sur l’utilisation des Collections dans Craft. Avant de publier, elle veut s’assurer qu’il est clair et complet.L’Assistant analyse le document et fournit des retours :
- Structure : “L’introduction est solide, mais la section 2 est deux fois plus longue que les sections 3 et 4 réunies. Envisagez de la diviser en deux parties.”
- Clarté : “Plusieurs termes techniques (relations, propriétés, vues) sont utilisés avant d’être définis. Ajoutez un glossaire ou définissez-les à la première utilisation.”
- Exhaustivité : “L’article explique ce que sont les Collections mais ne couvre pas quand les utiliser par rapport aux dossiers ou aux tags.”
- Qualité : “Le ton est cohérent. Une section redondante à la fin reprend l’introduction : envisagez de la supprimer.”
Sarah effectue des ajustements en fonction des retours : elle divise la section 2, ajoute des définitions, inclut une section « Quand utiliser les Collections » et supprime les redondances.
Limitations
La Revue de document fournit des retours mais n’applique pas directement les modifications. Pour agir sur les suggestions, passez en mode Execute avec un modèle Fast ou Max et demandez à l’Assistant de mettre en oeuvre les changements recommandés. Voir Édition avec Craft Assistant. Pour les documents très courts (moins de 200 mots), la Revue de document n’apporte pas forcément beaucoup de valeur : le chat général de l’Assistant est souvent plus adapté pour les tâches rapides.Articles connexes
Utiliser Craft Assistant
Apprenez à travailler avec l’Assistant et à démarrer des conversations
Choisir un modèle d'IA
Sélectionnez le bon modèle pour la Revue de document et d’autres tâches
Édition avec Craft Assistant
Appliquez les suggestions de revue directement en mode Execute
Prompts personnalisés
Créez des instructions de revue réutilisables pour des retours cohérents
Crédits
Comprenez l’utilisation des crédits pour la Revue de document et d’autres fonctionnalités