Polysh pour les agents est en accès anticipé. Votre agent de code enregistre la démo, Polysh la finalise. Rejoindre la liste d'attente →

Vérificateur de lisibilité de documentation

Obtenez un score de facilité de lecture de Flesch et un niveau scolaire par section.

Cet outil analyse du texte en anglais.

Chargement de l'outil dans votre navigateur…

Ce que fait Vérificateur de lisibilité de documentation

Les formules de lisibilité transforment la longueur des phrases et des mots en score. Collez un article d’aide, une SOP ou une page de documentation en anglais pour obtenir la facilité de lecture de Flesch, où plus haut signifie plus facile, et le niveau scolaire Flesch-Kincaid, où plus bas signifie plus facile, pour tout le texte et pour chaque section sous son titre.

C’est le tableau des sections qui rend l’outil utile pour les longs documents : une seule section Architecture dense peut faire basculer un guide accessible dans la zone difficile, et les sections sous 50 sont signalées en gras. Les blocs de code et les titres sont exclus : une page pleine d’exemples n’est pas pénalisée. Les phrases au-delà de la limite, 25 mots par défaut, sont comptées dans leur propre vignette.

Exemple

Entrée

## Quick start
Open the app. Click New video. Pick a recording from your library.

## How rendering works
The renderer combines your recording, the generated voiceover, and the caption track into a single file. Larger projects take longer because every frame is processed again.

Résultat

Reading ease: 52.2 (fairly difficult)
Grade level: 7.9
Quick start: ease 69, grade 4.7
How rendering works: ease 41, grade 10.8

La section Quick start, aux phrases courtes, se lit facilement ; les mots plus longs de la deuxième section font passer le score global sous 60.

Mode d'emploi : Vérificateur de lisibilité de documentation

  1. Collez le document avec ses titres, ou cliquez sur « Utiliser l’exemple ».
  2. Réglez « Signaler les phrases de plus de » sur la longueur maximale autorisée par votre guide de style.
  3. Commencez la révision par les lignes en gras du tableau « Section », « Facilité », « Niveau », « Mots ».

Bon à savoir

  • Les syllabes sont estimées à l’aide de règles et d’une liste d’exceptions : les noms de produits et les termes techniques peuvent faire varier le score de quelques points.
  • Les sections très courtes donnent des scores instables, car un seul mot long peut déplacer de nombreux points une section de deux phrases. Jugez les sections de 100 mots ou plus.
  • Les scores peuvent descendre sous zéro pour un texte technique dense. C’est le fonctionnement de la formule de Flesch, pas une erreur.
  • Les scores de lisibilité mesurent la longueur des phrases et des mots, pas la clarté. Pour repérer les mots vagues et les étapes à plusieurs actions, utilisez le Vérificateur de complexité des instructions.

Questions sur Vérificateur de lisibilité de documentation

Qu’est-ce qu’un bon score de facilité de lecture de Flesch ?

60 à 70 correspond à un anglais courant que la plupart des adultes lisent sans effort, un bon objectif pour un contenu d’aide. 70 et plus est facile. Sous 50, c’est assez difficile, et sous 30 cela se lit comme un texte universitaire. La documentation technique se situe souvent entre 40 et 59.

À quel niveau scolaire rédiger une documentation ?

Visez le niveau 8 ou moins pour les centres d’aide, l’onboarding et les SOP. La documentation pour développeurs se situe souvent aux niveaux 9 à 12 à cause des termes techniques, mais garder des phrases courtes aide quand même les lecteurs dont l’anglais n’est pas la langue maternelle.

Comment se calcule le niveau Flesch-Kincaid ?

C’est 0,39 fois le nombre moyen de mots par phrase, plus 11,8 fois le nombre moyen de syllabes par mot, moins 15,59. La facilité de lecture utilise les deux mêmes données avec des pondérations différentes. Des phrases plus courtes et des mots plus courts améliorent tous deux le score.

Comment rendre une SOP plus facile à lire ?

Limitez chaque étape à une action, commencez chacune par un verbe, utilisez les mots que votre équipe emploie vraiment et déplacez le contexte dans une section à part. Vérifiez le score ici, puis commencez par les sections à la facilité la plus faible.