Mes astuces pour réaliser de bons tutoriels
vendredi 3 octobre 2025 à 18:54
Ça fait une quinzaine d’années que je participe (ici ou ailleurs) à rédiger des tutoriels ou des instructions pour réaliser certaines opérations ou enseigner des trucs. Je ne prétends pas détenir la formule secrète qui permet à coup sûr de faire « un bon tuto », mais je constate quand-même que si un tuto ne dispose pas d’un minimum de choses, il n’arrivera pas a être « bon ».
Voici ici les points que je juge essentiel.
Rien n’est trivial
C’est probablement le point le plus important de tous.
Pas seulement dans un tutoriel, mais tout le temps quand on transmet une information. Il faut tout expliquer.
Tout doit venir de la personne qui explique, car personne ne dira qu’il n’a pas compris, et personne n’a jamais de questions quand on leur demande s’ils en ont. C’est un problème humain, oui, mais c’est à nous d’en tenir compte.
Dans un document écrit, cela ne coûte rien de prendre quelques lignes de plus pour approfondir un peu les explications, y compris de choses que vous jugez simples.
Aussi, précisez votre vocabulaire. Il peut être utile de définir ce dont on parle : soit directement dans le texte en définissant un terme ou un sigle, soit à l’aide d’un lexique, au début ou à la fin du document, ou bien en bas des pages, voire dans un autre document qui lui définit les termes.
Par exemple, quand je dis que sur Windows 10, on peut activer le compte administrateur avec la commande net user Administrateur /active:yes
, une partie du public ne sera pas vraiment avancé : où cette commande doit-être être lancée ? Comment y accéder ? Quels sont les pré-requis ? Comment savoir si la manipulation a fonctionné ? Comment l’inverser ?
Quand une instruction indique « mettez la machine en route.1 » : comment on fait ça ? Où se trouve le bouton ? Faut-il brancher quelque chose ? Comment on l’éteint ensuite ? Ces choses-là devraient être mentionnées.
J’opère professionnellement sur des appareils où il y a jusqu’à 5 étapes à faire dans l’ordre pour que l’appareil soit opérationnel (et ça c’est sans compter le branchement de la machine). Je connais ces étapes, mais que faire si je ne suis pas là et que ces manipulations ne sont écrites nulle part ?
Je considère qu’un bon tutoriel ou une bonne instruction doit pouvoir être suivie par n’importe quelle personne qui tombe dessus.
Et malgré les apparences, ce n’est pas simple de faire une instruction précise et complète.
Tout a une raison d’être
Écrivez le but de tel ou telle manip, telle ou telle chose à faire, ou à un pas faire. Quand on écrit d’utiliser un tournevis philips plutôt qu’un cruciforme, dîtes pourquoi. Car l’opérateur qui tombera dessus, ne le saura pas forcément. Car l’opérateur qui tombe dessus ne connaît peut-être pas la différence entre un philips et un cruciforme.
Car si l’usage d’un outil approprié est connu pour produire des problèmes, il faut que l’on soit prévenu. Je travaille personellement dans l’aéronautique : une erreur de manipulation ou de suivi d’une instruction, et ce sont des vies de perdues. Dans mon travail, je ne parle pas d’une erreur de choix de type de café à la machine, dont les conséquences sont absolument minimes. Dans mon cas, une erreur, et l’avion s’écrase.
Si un traitement thermique indique 180 °C, ce n’est pas 170 °C, ni 190 °C. Il faut expliquer pourquoi dans les instructions. Peut-être pas aller en détail jusqu’à la chimie ou la cristallographie du matériau, mais au moins expliquer les conséquences d’un travail bâclé.
Dans une instruction quelconque, il peut être utile d’expliquer ces étapes. Pour un tuto informatique, ajoutez des commentaires dans le code source, ou en face des lignes de commande à taper dans un terminal.
Dans un tuto de cuisine, on peut ajouter une ligne expliquant pourquoi le poivre ne s’ajoute qu’à la fin de la recette. Ou pourquoi le respect du temps d’infusion d’un cru de thé est important : trop court, ça n’a pas de goût (mais la caféine est très active), trop long et un thé vert sera amère. Tout ça reste au goût du consommateur, mais on peut supposer que des experts sont passés là avant pour créer une consigne qui soit convenable à la moyenne des gens.
Idem quand on fait un cours de math sur les dérivées ou les primitives : c’est bien joli de connaître de faire les dérivées, mais si l’on ne dit pas ce qu’est une dérivée matériellement parlant, ça restera abstrait, mal compris, donc mal appris aussi.
Savoir à qui l‘on s’adresse
Le premier point de cet article en appelle un autre : le public visé.
Il est primordial de savoir à qui on a à faire : s’adresse-t-on à un public totalement novice ? intermédiaire ? expert ?
En effet, dans le cas d’un tutoriel informatique, par exemple sur l’installation et l’utilisation d’un logiciel, le novice (typiquement : votre grand-mère) a besoin de quelques lignes de plus pour savoir « comment installer un logiciel », alors que l’expert n’en a pas besoin. Pour l’expert, on pourra passer directement aux étapes intéressantes sans s’attarder. Mais il faut être sûr que personne d’autre qu’un soi-disant expert va utiliser votre document.
Dans le domaine professionnel, on peut limiter l’accès du document aux seules personnes habilitées, formée, certifiée. Dans ce cas, il faut le mentionner : « la manipulation qui va suivre ne doit être réalisée que par des personnes disposante d’une habilitation XYZ ». Une personne habilitée a été formée pour certaines opérations précises, et est tenue de connaître certains termes précis. Ou, à défaut, est assez compétent pour savoir mettre une machine en route sans lui expliquer comment fonctionne un bouton on/off.
L’on pourra dans ce cas se dispenser de mettre certaines explications triviales pour ce public.
S’assurer qu’une personne est habilitée ou formée, c’est le gage qu’elle sait ce qu’elle s’apprête à faire et connaît les termes associés.
Soyez précis
Mettre, dans un tuto, des expressions comme « effectuez l’installation en suivant la procédure normale » ou « manipulez ce produit avec les précautions appropriées » ou « effectuez la manipulation selon les instructions adéquates » ça ne sert à rien.
Déjà, que signifient « normale », « appropriées », « adéquats » ? Ces termes sont subjectifs : ce qui est « normal » pour quelqu’un ne l’est pas pour quelqu’un d’autre.
Ensuite, quand on parle de « procédure » ou « d’instruction » : lesquelles cible-t-on ? Portent-elles un nom ? Un numéro ? Un indice de révision ? Si oui, il faut l’ajouter : déjà ça ne coûte rien d’être précis, et ça ne peut qu’aider celui qui va lire, et ensuite cela lève absolument toute ambiguïté, et ça, c’est également important.
Indiquez également où se trouve le document ou qui peut nous le fournir.
Par exemple : pour la manipulation d’un produit chimique, les précautions appropriées doivent suivre les recommandations du système général harmonisé de classification et d’étiquetage des produits chimiques. Si c’est le cas pour votre instruction, il faut le mentionner par une référence : une liste de documents de références, un lien si vous êtes en ligne, sinon un extrait du document source.
Plus généralement, quand on réfère à un autre document, liez-le. Quand on réfère à un appareil ou un outillage, donnez sa référence précise (et pas « outillage approprié »).
Soyez pratique
Avant de commencer la rédaction d’un tuto ou d’une instruction, donnez les pré-requis : de quoi va-t-on avoir besoin ?
Les instructions de chez Lego ou de chez Ikea sont claires : elles commencent toujours par lister les pièces présentes dans le produit et celles que l’on devra avoir pour monter le meuble (marteau, tournevis, une surface plane…).
En informatique, pour l’installation d’un programme, donnez la liste précise des fichiers et programmes, ainsi que des permissions nécessaires (admin…). Précisez immédiatement le système d’exploitation visé et sa version.
Rien de plus décevant que de télécharger un fichier dmg ou .deb quand alors qu’on est sous Windows.
Rien de plus frustrant que de chercher partout un menu qui n’est pas affiché, car on n’est pas connecté en administrateur.
Rien n’est plus énervant que de vouloir installer une nouvelle machine dans un atelier pour se rendre compte qu’il manque une prise électrique triphasée 380 V ou une arrivée d’eau.
Suivez votre propre instruction
Vous écrivez votre tutoriel de mémoire ? Vous allez oublier des choses ou inverser des étapes.
Rédigez votre tutoriel en même temps de faire les manipulations : tout ce que vous faites doit se retrouver sur le papier.
Ensuite, recommencez tout en suivant votre tutoriel et en vous mettant à la place d’un novice. Si quelque chose manque ou n’est pas à sa place, ça se verra et vous éviterez à votre public des heures d’arrachage de cheveux.
Enfin, idéalement, donnez votre tutoriel à quelqu’un de novice et faites le lui suivre. S’il manque des choses ou si certains passages sont confus, dites-lui de vous les signaler, ou de les noter. Modifiez ensuite votre document.
Cette façon de faire permet de s’assurer que votre tutoriel ou instruction fonctionne, et pas seulement pour vous, mais aussi pour une autre personne susceptible de se retrouver devant la machine.
Utilisez le bon vocabulaire
Un bouton n’est pas un câble, ni un interrupteur, ni un menu sur un écran.
Tout comme Internet n’est pas Edge, ni Google, ni SFR.
Les mots ont un sens : choisissez-les soigneusement.
Le vocabulaire est technique ? Définissez les termes ! Soit dans un lexique, soit dans un chapitre dédié du document.
Toutes les bonnes instructions ou manuels d’utilisateur fonctionnent comme ça : ils commencent tous par lister les termes, sigles ou pictogrammes employées dans les documents. Il faut se rappeler que le but c’est de permettre à quelqu’un d’autre de reproduire une procédure, une suite d’actions à opérer dans un cas précis pour obtenir un résultat donné. Il faut que l’ensemble soit le moins ambigu possible, et pour ça le choix des mots est important.
Utilisez la RFC 2119
Les RFC ce sont des recommandations techniques sur internet, mais on peut les appliquer ailleurs.
Dans une instruction, certaines manipulations sont obligatoires, d’autres seulement recommandées. Certaines sont déconseillées, mais d’autres sont carrément interdites. Enfin, certaines sont optionnelles.
La RFC 2119 est simple et définit ce que signifient les termes comme « doit », « devrait », « peut » ou encore « peut ne pas » ou « ne peut pas ».
La RFC 2119 normalise ce vocabulaire et précise quand quelque chose doit être obligatoire au lieu de conseillée, ou encore interdite au lieu de déconseillée… ou alors facultative ou optionnelle. Inversement, la RFC décrit aussi le comportement à adopter quand on a une action ainsi qualifiée. Et ce que ça signifie pour le processus en cours.
Par exemple, une action déconseillée peut être réalisée dans certains cas où elle s’avérerait utile, mais ne devrait pas être faite autrement. De même, une action simplement conseillée devrait être faite, mais pourrait ne pas être faite s’il existe une raison où cette action serait inutile (ou impossible, ou inappropriée).
C’est assez bête, ça peut sembler ridicule, mais quand une instruction dit « doit », alors ce n’est pas la même chose que « peut ». Dire « vous pouvez désormais appuyer sur ce bouton » ce n’est pas la même chose « vous devez désormais appuyer sur ce bouton ».
La RFC 2119 devrait selon moi être appliquée partout. Encore une fois, les mots ont un sens et les employer correctement évite des frustrations, des erreurs, et des accidents. Inversement, la lecture de ces mots doit suivre ce qu’ils énoncent : si une ligne est obligatoire, elle doit être exécutée, sinon le résultat attendu ne sera pas là (et ça ne sera pas le problème de l’instruction).
Le but d’une instruction est d’aider l’opérateur, mais elle permet aussi de dédouaner le constructeur. Si l’instruction indique qu’une opération « doit » être faite, mais que l’opérateur ne l’a pas fait faite et que maintenant la machine est en panne, la responsabilité est celle de l’opérateur, pas du constructeur (typiquement une opération de maintenance, par exemple).
Conclusion
Si je devais résumer tout ça :
- posez les bases : matériel requis, habilitations nécessaires, et même le temps nécessaire (temps de chauffe, de préparation) ;
- pour les termes techniques, utilisez des termes précis, et au besoin définissez-les ;
- pour les étapes à suivre, dîtes si elles sont obligatoires ou optionnelles. Si elles sont optionnelles, donnez des exemples de cas d’application, et ce que leur application implique sur le reste de la procédure ;
- ajoutez une mot sur le but d’une manip : pourquoi c’est important, quelles sont les conséquences de son omission ;
- enfin, détaillez tout très précisément.
Notes
[1] : Et écrivez bien « mettez la machine en marche » et non pas « allumez l’appareil », car vous pourrez être sûr qu’un jour quelqu’un va littéralement l’allumer. Avec du feu.
Image d’en-tête par Google Gemini (IA).