Comment nous préparons un tutoriel avant de le publier

Tout commence par une question entendue en atelier

Un tutoriel ne naît jamais d'une idée brillante au bureau. Chez nous, il naît d'une phrase prononcée à voix haute dans une bibliothèque ou un centre culturel : « Je n'arrive pas à retrouver mon livre numérique », « Où faut-il appuyer pour que l'émission passe sur la télévision ? ». Je note ces phrases telles quelles, avec les mots exacts des participants, parce qu'ils décrivent le problème mieux que n'importe quel vocabulaire technique.

Lorsqu'une même question revient dans trois ateliers différents, nous la transmettons à Philippe Lambert, qui rédige les guides pratiques. Il vérifie d'abord qu'une démarche officielle existe, sur le site de l'éditeur ou de la bibliothèque concernée. Si la réponse passe par un lien douteux ou par une application dont on ne connaît pas l'origine, nous ne publions rien tant que le chemin sûr n'est pas identifié.

Le test sur un vrai appareil, du début à la fin

Philippe ne rédige pas depuis ses souvenirs. Il déroule la démarche sur un appareil réglé comme celui de nos lecteurs : une tablette d'entrée de gamme, un ordinateur portable de quelques années, un téléviseur raccordé au réseau de la maison. Il part d'un écran d'accueil neuf, sans compte créé, sans identifiant mémorisé, pour ne rien oublier d'une étape.

À chaque écran, il fait une capture et note ce qu'il voit, y compris les messages qui surprennent : une demande d'autorisation, une fenêtre qui propose un essai payant, un bandeau publicitaire placé près du bouton de lecture. Ces détails comptent autant que les gestes eux-mêmes, car ce sont eux qui font hésiter un lecteur et parfois le font cliquer au mauvais endroit.

• Départ d'un appareil sans compte ni mémorisation
• Une capture d'écran à chaque étape
• Les fenêtres inattendues sont notées et expliquées

Écrire des étapes courtes, une action par phrase

Vient ensuite la rédaction. Notre règle est simple : une phrase, une action. « Touchez le bouton Emprunter » se suffit à lui-même ; on n'y ajoute ni explication sur le fonctionnement du catalogue ni digression sur les formats de fichier. Si une précision est utile, elle vient dans une phrase séparée, juste après l'étape qu'elle concerne.

Nous indiquons aussi, à chaque fois, ce qui doit apparaître à l'écran une fois l'étape accomplie. Cette phrase de contrôle rassure : le lecteur sait qu'il est sur la bonne voie, ou comprend tout de suite qu'il s'est écarté du chemin. Nous employons le vocabulaire de l'écran tel qu'il est affiché, sans le traduire ni l'enjoliver, pour que chacun retrouve exactement le mot qu'il a sous les yeux.

La relecture par ceux qui s'en serviront

Avant publication, le brouillon est mis entre les mains de volontaires, souvent des participants à nos ateliers. Je leur demande de suivre le guide seuls, sans que je dise un mot, pendant que j'observe de loin. Chaque fois qu'une personne s'arrête, relit une phrase ou lève les yeux vers moi, je marque l'endroit : c'est là que le texte doit être repris.

Les remarques sont parfois très concrètes. Une lectrice m'a fait remarquer qu'« icône » ne lui disait rien, mais qu'« le petit dessin en forme de maison » lui parlait immédiatement. Nous avons changé le texte. Ce genre de retour vaut plus que toutes les relectures de rédaction, et il explique pourquoi nos guides ressemblent à la manière dont on parle autour d'une table.

• Lecture silencieuse, sans aide de l'animatrice
• Chaque hésitation marque une phrase à reprendre
• Les mots des participants remplacent le jargon

Garder un guide à jour quand les écrans changent

Un site officiel modifie parfois la disposition de ses boutons, et un tutoriel exact en automne peut devenir trompeur quelques mois plus tard. Nous repassons donc sur les guides publiés à intervalles réguliers, en refaisant la démarche complète plutôt qu'en vérifiant seulement les pages qui nous semblent concernées.

Quand un écran a changé, nous remplaçons la capture et la phrase correspondante, puis nous relisons l'ensemble pour vérifier que les étapes suivantes tiennent toujours. Si une démarche devient floue ou si elle pousse vers un service payant que le lecteur n'a pas demandé, nous préférons la retirer plutôt que de la laisser en ligne avec une réserve. Un guide ancien mais faux est plus dangereux qu'un guide absent.

Ce que cela change pour vous, lecteur

Derrière une page qui semble simple, il y a donc un test complet, plusieurs relectures et souvent une reprise après l'avis des participants. Cette lenteur est voulue. Elle permet de vous proposer des étapes que d'autres ont déjà suivies avec succès, sur des appareils ordinaires, sans connaissances préalables.

Si une explication vous paraît encore obscure, c'est un signal utile pour nous : parlez-en en atelier ou écrivez-nous par le formulaire de la page de contact. Votre difficulté d'aujourd'hui deviendra peut-être la phrase mieux écrite de la prochaine version, et servira à d'autres lecteurs qui n'osaient pas poser la question.