La Révision de document fournit des retours structurés et exploitables sur votre rédaction. Au lieu de poser des questions générales à l’Assistant, la Révision de document analyse l’intégralité de votre document et propose des observations sur sa structure, sa clarté, sa complétude et sa qualité globale. Cela vous aide à détecter les problèmes avant de partager, à améliorer la qualité du contenu et à obtenir un regard extérieur sur votre travail – sans jamais quitter 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.
Ce que fait la Révision de document
La Révision de document examine votre document selon plusieurs dimensions : Structure et organisation :- Fluidité et progression logique
- Hiérarchie et cohérence des titres
- Équilibre des sections et rythme
- Architecture de l’information
- Complexité et longueur des phrases
- Utilisation du jargon et du langage technique
- Transitions entre les idées
- Score de lisibilité global
- Contexte ou arrière-plan manquant
- 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étition
- Opportunités d’amélioration
Comment lancer une Révision de document
L’Assistant parcourt l’intégralité de votre document et fournit des retours structurés organisés par catégorie.
La Révision de document fonctionne avec tous les modèles, mais Max fournit les retours les plus approfondis et nuancés, en particulier pour les documents longs ou complexes. Pour des vérifications rapides, Fast offre un bon équilibre entre profondeur et vitesse.
Révision de document vs chat général avec l’Assistant
| Fonctionnalité | Révision de document | Chat général avec l’Assistant |
|---|---|---|
| Objectif | Retours structurés sur le document | Conversation et tâches ouvertes |
| Portée | Analyse du document entier | Répond à des questions précises |
| Format de sortie | Organisé par catégories de retours | Réponses conversationnelles |
| Profondeur | Complète, multidimensionnelle | Centré sur votre question spécifique |
| Idéal pour | Contrôles qualité, révisions avant publication | Modifications rapides, résumés, requêtes sur le contenu |
| Questions de suivi | Peut poser des questions de clarification | Conversation continue |
| Utilisation | Élevée (analyse le document entier) | Variable selon la complexité de la requête |
Quand utiliser la Révision de document
La Révision de document est la plus utile dans ces situations :Avant un partage externe
Révisez des présentations, propositions ou documents destinés aux clients pour détecter les problèmes de structure, les sections peu claires ou le contexte manquant avant de les envoyer.Assurance qualité
Effectuez des révisions périodiques sur des documentations importantes, 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 des articles de blog, des rapports ou des écrits 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 coéquipiers, 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 révisions pour comprendre les patterns dans votre rédaction – les problèmes de clarté récurrents, les tendances structurelles, ou les domaines où vous avez régulièrement besoin de progresser.Vous pouvez lancer la Révision de document plusieurs fois. Apportez des modifications basées sur les retours, puis révisez à nouveau pour vérifier si les problèmes sont résolus. Cette approche itérative vous aide à apprendre ce qui fonctionne et à affiner votre contenu progressivement.
Comprendre les retours
Les retours de la Révision de document sont organisés en catégories claires. Voici comment les interpréter et les utiliser :Retours sur la structure
Ce qu’ils vous indiquent : À quel point votre contenu est fluide, si les sections sont équilibrées et si l’architecture de l’information est cohérente. 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 passe de H2 à H4 »
Retours sur la clarté
Ce qu’ils vous indiquent : Si votre rédaction est facile à comprendre, si les phrases sont trop complexes et où les lecteurs pourraient être confus. Exemples de retours :- « Ce paragraphe utilise beaucoup la voix passive, ce qui le rend plus difficile à suivre »
- « Le jargon technique dans la première section peut déconcerter les lecteurs non experts »
- « La longueur moyenne des phrases est de 35 mots – envisagez de les diviser en phrases plus courtes »
Retours sur la complétude
Ce qu’ils vous indiquent : Les lacunes dans 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 supposent des connaissances préalables non couvertes dans l’introduction »
- « Pas de conclusion ni de 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 de peaufiner votre contenu. Exemples de retours :- « Le ton passe du formel au décontracté entre les sections »
- « Les listes à puces sont mises en forme de façon incohérente (certaines se terminent par un point, d’autres non) »
- « Ce concept est expliqué deux fois – envisagez de les regrouper »
Utilisation
La Révision de document utilise plus de votre quota IA qu’une simple question, car elle analyse l’intégralité du document en une seule passe. Les documents plus longs et complexes consomment davantage. Utilisez Fast pour des révisions plus rapides et légères.L’utilisation réelle dépend de la longueur du document, de sa structure, de la complexité de la mise en forme et du modèle choisi. Vérifiez votre utilisation dans le menu de l’Assistant sous Utilisation & Limites.
Conseils pour de meilleures révisions
1. Préparez votre document au préalable Assurez-vous que votre document est raisonnablement complet avant de lancer une révision. L’Assistant fournit de meilleurs retours sur des brouillons aboutis que sur des plans grossiers. 2. Précisez votre audience Dans une question de suivi, dites à l’Assistant à qui est destiné le document :- « C’est pour une équipe technique familière avec le produit »
- « L’audience est composée de parties prenantes non techniques »
- « Rédigé pour des nouveaux utilisateurs n’ayant jamais utilisé Craft »
- « Quels sont les 3 problèmes à corriger en premier ? »
- « Quel est le problème structurel le plus critique ? »
- « Concentre-toi uniquement sur les problèmes de clarté »
- « Révise pour la cohérence du ton »
- « Vérifie uniquement la complétude et le contexte manquant »
- « Concentre-toi sur la pertinence de la structure pour un public débutant »
- On-device : Non recommandé pour la Révision de document (contexte limité)
- Core : Vérifications structurelles rapides sur des documents courts
- Fast : Bon équilibre pour la plupart des révisions (500 à 2 000 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 le publier, elle veut s’assurer qu’il est clair et complet.L’Assistant analyse le document et fournit ses retours :
- Structure : « L’introduction est solide, mais la section 2 est deux fois plus longue que les sections 3 et 4 combinées. 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 occurrence. »
- Complétude : « L’article explique ce que sont les Collections mais ne couvre pas quand les utiliser plutôt que des dossiers ou des tags. »
- Qualité : « Le ton est cohérent. Une section redondante à la fin reprend l’introduction – envisagez de la supprimer. »
Sarah apporte des ajustements basés sur les retours : divise la section 2, ajoute des définitions, inclut une section « Quand utiliser les Collections » et supprime la redondance.
Limitations
La Révision de document fournit des retours mais n’applique pas les modifications directement. Pour mettre en œuvre les suggestions, passez en mode Exécuter avec un modèle Fast ou Max et demandez à l’Assistant d’implémenter les modifications recommandées. Voir Éditer avec Craft Assistant. Pour les documents très courts (moins de 200 mots), la Révision de document peut n’apporter que peu de valeur – le chat général avec l’Assistant est souvent plus approprié pour les tâches rapides.Articles connexes
Utiliser Craft Assistant
Apprenez à travailler avec l’Assistant et à démarrer des conversations
Choisir un modèle IA
Sélectionnez le bon modèle pour la Révision de document et d’autres tâches
Éditer avec Craft Assistant
Appliquer les suggestions de révision directement en mode Exécuter
Prompts personnalisés
Créer des instructions de révision réutilisables pour des retours cohérents
Utilisation & Limites
Comprendre l’utilisation IA pour la Révision de document et autres fonctionnalités