> ## Documentation Index > Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Révision de document > Obtenez des retours IA structurés sur la structure, la clarté et la complétude de votre document. 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. ## 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 **Clarté et lisibilité :** * Complexité et longueur des phrases * Utilisation du jargon et du langage technique * Transitions entre les idées * Score de lisibilité global **Complétude :** * Contexte ou arrière-plan manquant * Lacunes dans les explications * Questions sans réponse * Zones nécessitant un développement **Signaux de qualité :** * Cohérence du ton * Problèmes de mise en forme * Redondance et répétition * Opportunités d'amélioration La révision est objective, précise et exploitable – vous obtenez des suggestions concrètes, pas des retours vagues. ## Comment lancer une Révision de document Ouvrez le document que vous souhaitez réviser. Cliquez sur l'icône de l'Assistant dans le coin inférieur. Sélectionnez **Nouveau chat**. Choisissez **Révision de document** dans le sélecteur de mode. Attendez la fin de l'analyse (généralement 10 à 30 secondes). 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 | Utilisez la **Révision de document** pour obtenir des retours complets sur l'ensemble du document. Utilisez le **chat général** pour des questions ou tâches spécifiques. ## 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 » **Comment les utiliser :** Réorganisez les sections, ajustez le rythme, corrigez les niveaux de titres ou ajoutez du contenu de transition. ### 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 » **Comment les utiliser :** Simplifiez les phrases, remplacez le jargon par un langage courant ou ajoutez des définitions pour les termes techniques. ### 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 » **Comment les utiliser :** Ajoutez le contexte manquant, développez les sections légères ou incluez des résumés et des conclusions. ### 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 » **Comment les utiliser :** Standardisez la mise en forme, maintenez un ton cohérent, supprimez les redondances. ## 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**. Les retours complets permettent souvent de gagner du temps et d'améliorer la qualité plus efficacement que de multiples requêtes individuelles. ## 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 » Ce contexte aide l'Assistant à adapter ses retours à vos besoins spécifiques. **3. Demandez des retours priorisés** Si la révision identifie de nombreux problèmes, demandez à l'Assistant de prioriser : * « 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é » **4. Demandez des types de retours spécifiques** Vous pouvez guider la révision en demandant une analyse ciblée : * « 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 » **5. Utilisez le bon modèle** * **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. Sarah ouvre son brouillon dans Craft. Elle clique sur l'icône de l'Assistant et sélectionne **Révision de document**. 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. Elle relance la Révision de document. L'Assistant confirme que les problèmes sont résolus. Sarah publie en toute confiance, sachant que le contenu est clair et complet. ## 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](/fr/ai-assistant/editing). 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 Apprenez à travailler avec l'Assistant et à démarrer des conversations Sélectionnez le bon modèle pour la Révision de document et d'autres tâches Appliquer les suggestions de révision directement en mode Exécuter Créer des instructions de révision réutilisables pour des retours cohérents Comprendre l'utilisation IA pour la Révision de document et autres fonctionnalités