Passer au contenu principal

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.

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

1
Ouvrez le document que vous souhaitez réviser.
2
Cliquez sur l’icône de l’Assistant dans le coin inférieur.
3
Sélectionnez Nouveau chat.
4
Choisissez Révision de document dans le sélecteur de mode.
5
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 documentChat général avec l’Assistant
ObjectifRetours structurés sur le documentConversation et tâches ouvertes
PortéeAnalyse du document entierRépond à des questions précises
Format de sortieOrganisé par catégories de retoursRéponses conversationnelles
ProfondeurComplète, multidimensionnelleCentré sur votre question spécifique
Idéal pourContrôles qualité, révisions avant publicationModifications rapides, résumés, requêtes sur le contenu
Questions de suiviPeut poser des questions de clarificationConversation 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.
1
Sarah ouvre son brouillon dans Craft.
2
Elle clique sur l’icône de l’Assistant et sélectionne Révision de document.
3
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. »
4
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.
5
Elle relance la Révision de document. L’Assistant confirme que les problèmes sont résolus.
6
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. 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