polyshVérificateur de complexité des instructions
Trouvez les étapes trop chargées, évasives ou qui cachent qui agit.
- Fonctionne dans votre navigateur
- Aucun envoi de fichier
- Aucun compte
Cet outil analyse du texte en anglais.
Chargement de l'outil dans votre navigateur…
Ce que fait Vérificateur de complexité des instructions
De bonnes instructions font une chose par étape. Collez une procédure en anglais : chaque étape est contrôlée pour les problèmes qui obligent à s’arrêter et relire, à savoir deux actions ou plus sur une ligne comme select et click, des conditions commençant par if ou unless, des étapes au-delà de la limite de mots, des mots vagues comme simply, just ou as needed, et la voix passive.
Si le texte contient un titre Procedure ou Steps, seules les étapes placées dessous sont contrôlées. Sinon, chaque étape ou phrase l’est. La note est « Faible » quand aucune étape n’est signalée, « Modérée » quand moins d’un tiers le sont, et « Élevée » au-delà. Chaque signalement dit quoi faire, par exemple découper en étapes distinctes ou envisager une étape de décision distincte.
Exemple
Entrée
## Procedure 1. Open Users. 2. Select the account and click Reset MFA. 3. If the user is an admin, notify security. 4. Simply close the ticket.
Résultat
Complexity: High (3 of 4 steps need attention) 1. Clear 2. 2 actions (select, click), split into separate steps 3. Condition (if), consider a separate decision step 4. Vague or jargon words: simply
Mode d'emploi : Vérificateur de complexité des instructions
- Collez votre procédure, idéalement avec un titre Procedure au-dessus des étapes.
- Réglez « Signaler les phrases de plus de » sur votre limite de mots pour une étape.
- Corrigez chaque étape qui n’est pas marquée « Aucun problème », en commençant par celles qui ont plus d’un signalement.
Bon à savoir
- Les actions sont repérées à partir d’une liste fixe de verbes d’interface courants. Les étapes qui combinent des verbes moins courants, comme pick ou launch, peuvent ne pas être signalées comme multi-actions.
- Certains mots vagues ont des usages anodins. Just dans just under 2 MB et some dans some users sont aussi signalés : faites preuve de discernement.
- Les conditions sont signalées même quand elles sont le bon choix. Un if court en début d’étape est souvent plus clair qu’une étape de décision séparée.
Questions sur Vérificateur de complexité des instructions
Comment rédiger des instructions étape par étape claires ?
Commencez chaque étape par un verbe, donnez une action par étape, nommez exactement le bouton ou le champ, et dites ce que le lecteur doit voir ensuite. Placez les conditions en premier, comme dans If you see an error, et sortez les explications des étapes pour les mettre en notes.
Pourquoi chaque étape ne doit-elle contenir qu’une action ?
On suit des instructions en passant du document à l’écran. Avec une action par étape, on retrouve facilement sa place, et en cas d’échec on peut dire exactement quelle étape a posé problème. Deux actions sur une ligne sont la raison la plus fréquente pour laquelle une étape est sautée.
Pourquoi éviter des mots comme simply et just ?
Ils disent au lecteur qu’une étape est facile, ce qui donne à quiconque bloque le sentiment d’être en faute, et ils n’apportent rien à l’instruction. Les retirer rend les étapes plus courtes et plus neutres. Des expressions comme as needed sont pires, car elles cachent une décision que le lecteur doit prendre.