Des instructions peuvent vous sembler évidentes parce que vous connaissez déjà le résultat, alors qu'un lecteur s'arrête au premier détail manquant : quel fichier, où le placer et que signifie « terminé » ? Écrire des étapes reproductibles consiste à transformer votre savoir en une procédure qu'une autre personne peut suivre, puis à comparer son résultat à un objectif défini sans deviner vos intentions.
Nous utiliserons un exemple pédagogique original : préparer une enveloppe contenant trois cartes. Il ne s'agit ni du compte rendu d'une expérience réelle ni d'une affirmation selon laquelle des utilisateurs auraient testé la procédure. L'exemple illustre la rédaction et la révision d'instructions. L'image a été générée pour une scène de papeterie imaginaire. Ce contenu, préparé avec une aide de l'intelligence artificielle, n'a pas reçu de révision éditoriale humaine indépendante.
Définir le résultat avant la première étape
Commencez par quelque chose d'observable : « Une enveloppe ouverte contenant une carte avec un carré, une avec un cercle et une avec un triangle, sans carte supplémentaire. » C'est plus précis que « préparer correctement le matériel ». Le lecteur peut sortir les cartes, les compter et comparer les formes sans connaître votre définition personnelle d'une bonne disposition.
Distinguez le résultat exigé des détails sans effet sur celui-ci. Si l'ordre des cartes n'importe pas, modifier leurs positions ne doit pas constituer une erreur. S'il importe dans une autre tâche, indiquez-le explicitement avec une raison utile. Chaque contrainte doit servir l'objectif ; sinon, elle détourne l'attention du véritable critère de réussite.
Préciser le point de départ et le matériel
Notre exemple nécessite une enveloppe vide et trois cartes déjà préparées : un carré, un cercle et un triangle. Il ne suppose ni impression, ni découpage, ni outil supplémentaire. Précisez-le avant les étapes pour éviter qu'une personne découvre à mi-parcours l'absence d'un élément essentiel.
Pour une procédure numérique, le départ peut être un fichier d'essai ouvert ou un compte disposant d'une autorisation particulière. Décrivez ces conditions sans demander de mot de passe ni de contournement des droits d'accès. Si une condition manque, la bonne réponse peut être de s'arrêter et d'obtenir la ressource adaptée, plutôt que d'emprunter un détour non documenté.
Indiquer l'action, son lieu et son résultat observable
Le guide de Google sur les procédures aborde étapes ordonnées et contexte. Dans notre exercice, « préparez-les » reste incomplet. « Placez les trois cartes devant l'enveloppe pour examiner leurs formes » désigne les objets, l'action et la raison de leur emplacement.
Ne rassemblez pas des décisions sans rapport dans une longue phrase. À l'inverse, ne découpez pas un geste simple en fragments artificiels qui n'aident pas le lecteur. Une étape est une action compréhensible dont on peut reconnaître l'achèvement, pas un nombre fixe de mots. Une phrase plus courte n'est pas automatiquement plus claire si elle supprime une information nécessaire.
Exemple complet d'une petite procédure
Il s'agit de préparer une enveloppe avec les cartes indiquées et de la laisser ouverte pour vérification. Utilisez uniquement du matériel d'essai ; n'incluez pas de documents personnels.
- Posez l'enveloppe vide et les trois cartes sur une surface où vous pouvez travailler clairement.
- Examinez les formes : il faut un carré, un cercle et un triangle, un exemplaire de chaque. Si une forme manque ou se répète, arrêtez-vous et obtenez le bon ensemble.
- Comptez les cartes avant de les insérer. Le nombre attendu est trois.
- Placez les trois cartes dans l'enveloppe et laissez-la ouverte.
- Sortez les cartes pour les contrôler. Vérifiez un exemplaire de chaque forme et l'absence d'une quatrième carte.
- Remettez l'ensemble vérifié dans l'enveloppe ouverte et notez que le contrôle du contenu est terminé.
Le contrôle final diffère du simple constat qu'une enveloppe se trouve sur la table : elle peut être présente avec un contenu incomplet. Nous ne demandons pas non plus de la fermer puis de la rouvrir, puisque la fermeture ne fait pas partie de l'objectif. N'introduisez pas une modification inutile au critère de résultat.
Rendre les expressions vagues observables
| Expression vague | Formulation plus précise dans l'exercice | Que vérifier ? |
|---|---|---|
| Prenez les bonnes choses | Choisissez une carte carré, une cercle et une triangle | Présence des trois formes |
| Mettez-les là | Placez les cartes dans l'enveloppe ouverte | Emplacement et état de l'enveloppe |
| Vérifiez que tout va bien | Comptez trois cartes et une de chaque forme | Nombre et diversité des formes |
| Répétez si nécessaire | Préparez six enveloppes, chacune avec un ensemble complet | Nombre d'enveloppes et contenu individuel |
Si la tâche passe à six enveloppes, il faut six cartes de chaque forme, soit 6 × 3 = 18 cartes au total. En avoir 18 ne suffit pas : elles pourraient toutes porter un carré. La vérification combine donc quantité et répartition des types. L'une ne remplace pas l'autre.
Séparer les alternatives du parcours principal
Si l'ajout d'une étiquette est facultatif, précisez-le et indiquez que son absence ne fait pas échouer la tâche. Si deux parcours sont entièrement différents, présentez chacun comme une procédure séparée plutôt que de les mélanger à chaque ligne. Le lecteur doit savoir lequel il suit et où sa responsabilité s'arrête.
Une branche incomplète ne doit pas renvoyer à un début ambigu. Si la carte triangle manque, on revient par exemple au contrôle de l'ensemble après l'avoir obtenue, sans refaire toutes les enveloppes achevées. Indiquez le point de reprise, surtout lorsqu'une répétition peut doubler le travail ou modifier du matériel déjà contrôlé.
Utiliser l'image pour expliquer le difficile à décrire
La liste de Microsoft pour les instructions traite présentation et interaction. L'image de notre exercice aide à reconnaître les formes, mais ne prouve pas combien de cartes se trouvent dans l'enveloppe du lecteur. Le contrôle écrit reste nécessaire ; une illustration n'est pas une preuve de réussite.
Pour une interface, employez le nom visible de l'élément plutôt que seulement « le bouton bleu à droite ». Couleur et position peuvent changer. Le texte alternatif doit décrire l'information pertinente. Retirez les données personnelles d'une capture avant de la partager et ne présentez pas une image inventée comme documentation d'une interface réelle.
Tester le document sans fournir les réponses
Lorsqu'un essai avec une personne adaptée est possible, fournissez les instructions et le matériel prévu, puis observez où une question apparaît. Si vous expliquez oralement une étape absente, consignez cette aide. La réussite ultérieure ne prouve pas que le texte seul suffisait. Révisez la formulation puis reprenez depuis le point de départ annoncé.
Notez précisément : « Arrêt au mot ensemble, car les formes attendues étaient ambiguës » est plus utile que « n'a pas compris ». Dans un scénario fictif où deux lecteurs ont terminé avec aide et un troisième n'a pas essayé, n'annoncez pas « trois essais indépendants réussis ». Conservez résultat, conditions et révisions précédentes pour chaque tentative.
Expliquer quoi faire si le résultat diffère
Si l'enveloppe contient quatre cartes, comparez-les à la liste avant d'en retirer une. Il faut identifier la carte en trop, pas en enlever une au hasard pour atteindre trois. Si le triangle manque, arrêtez-vous à l'étape qui l'exige. Cela distingue la résolution de la cause du problème d'un simple embellissement du nombre final.
Pour un logiciel ou un appareil, un résultat inattendu ne justifie pas de remplacer la procédure du fabricant par une réinitialisation générale ou une suppression de fichiers. Précisez les informations enregistrables sans risque et où obtenir une assistance adaptée. Une procédure répétable n'autorise pas à répéter une action susceptible de produire des effets supplémentaires à chaque fois.
Conserver une version et annoncer les limites
Donnez au document un nom clair et un numéro de version ou une date ; consignez les modifications. Si une version ultérieure remplace trois cartes par quatre, actualisez ensemble matériel, étapes et contrôles. Modifier uniquement la liste du matériel crée une contradiction pour quiconque suit le reste à la lettre.
Distinguez « les étapes sont rédigées » de « testées dans ces conditions ». Un document peut être achevé sur le plan linguistique tout en attendant un essai pratique. Dites-le honnêtement ; n'inventez ni relecteurs ni résultats. Les usages sensibles nécessitent une procédure spécialisée approuvée par l'organisme responsable, pas cet exercice général sur papier.
Références et prochaine étape
Les deux références liées ont été lues le 2 novembre 2026. Exemple, calcul, tableau et méthode de consignation de l'aide ont été créés pour cet article ; les exemples et commandes des sources n'ont pas été reproduits. Choisissez une petite procédure non sensible, rédigez résultat, départ, étapes et contrôle, puis indiquez honnêtement ce qui doit encore être testé avant de s'y fier.
