Blog

Rédiger des titres et des notes d’étapes vraiment lus

Publié le 25 octobre 2026 · guides, rédaction, documentation, conseils

L’enregistrement d’un guide rédige la première version de chaque titre. Transformez-les en consignes, ajoutez la raison et l’avertissement, et gardez chaque étape courte.

Un guide enregistré arrive avec l’essentiel de la structure déjà fait : les captures dans l’ordre, un repère sur le clic, un titre pour chaque étape. Ce qu’il n’apporte pas, c’est le jugement. Les titres décrivent ce qui a été cliqué, pas ce que doit faire la personne qui suit. Une courte passe de réécriture corrige cela.

La première version est déjà là

InSnap construit le titre de chaque étape à partir de l’élément cliqué — « Ouvrir Réglages », « Sélectionner Notifications », « Activer les alertes e-mail ». C’est une bonne base, car elle s’appuie sur l’interface réelle, pas sur votre souvenir de celle-ci.

Ce n’est pas non plus une consigne. « Sélectionner Notifications » raconte ce qui s’est passé ; « Ouvrir la page Notifications » dit quoi faire. La différence est minime sur une étape et évidente sur vingt.

Transformer le titre en consigne

Trois habitudes :

• Commencez par le verbe. « Cliquer sur Enregistrer les modifications », pas « Bouton Enregistrer les modifications ». « Ouvrir », « Choisir », « Saisir », « Confirmer » sont clairs ; « le », « ce » et « ici » ne le sont pas.
• Une seule action par étape. Si le titre a besoin de « et », l’étape doit probablement être scindée. Les étapes enregistrées sont déjà petites ; les étapes retouchées doivent le rester.
• Nommez ce que le lecteur voit. Reprenez le libellé de l’interface, pas votre nom interne. Si le bouton dit « Publier », écrivez « Publier », même si l’équipe dit « mettre en ligne ».

Un bon test de longueur : le titre doit tenir sur une ligne dans la liste des étapes sans être tronqué. Sinon, c’est probablement une phrase plutôt qu’une étape.

Ajouter la raison, pas l’évidence

Le champ de description est l’endroit où un guide cesse d’être un tas de captures pour devenir utile. Le texte d’aide le dit bien : « pourquoi cette étape, à quoi faire attention ».

Les bonnes descriptions répondent à l’une de trois questions :

• Pourquoi cette étape existe-t-elle ? (« Cela évite que la modification touche le catalogue en ligne. »)
• Qu’est-ce qui change ensuite ? (« Le statut passe à En attente jusqu’à la prochaine synchronisation. »)
• Qu’est-ce qui rate si on la saute ? (« La modification est enregistrée mais jamais publiée. »)

Les mauvaises descriptions répètent le titre avec plus de mots. Si la description ne change pas ce que fait le lecteur, supprimez-la.

Utiliser des encadrés pour les avertissements

Toutes les notes ne méritent pas un paragraphe. L’éditeur de guides d’InSnap propose trois blocs d’encadré — Astuce, Avertissement et Remarque — qui s’affichent comme des cadres colorés dans chaque format d’export.

• Avertissement pour ce qui peut entraîner une perte de données ou un état cassé.
• Astuce pour un raccourci ou un chemin plus rapide.
• Remarque pour un contexte utile mais facultatif.

Les encadrés ne sont pas des étapes numérotées : ils n’interrompent donc pas la séquence. C’est l’endroit idéal pour ce que vous glisseriez sinon entre parenthèses dans un titre d’étape.

Découper les étapes longues avec des sous-étapes

Si une étape contient plusieurs petites actions dans un même écran — ouvrir un menu, choisir un sous-menu, confirmer —, faites de la première action une étape de premier niveau et des suivantes des sous-étapes. Elles apparaissent en N.1, N.2 et en retrait dans les exports, pour que le lecteur voie la structure sans que la numérotation reparte de zéro.

Les sous-étapes gardent aussi la liste principale lisible : dix étapes de premier niveau avec quelques sous-étapes se lisent mieux que vingt étapes à plat.

Masquer ce qui n’aide pas

L’enregistrement attrape ce qui ne fait pas partie du processus : un clic sur une notification, un changement d’onglet accidentel, un détour fait pendant la capture. Sélectionnez l’étape et masquez-la. Les étapes masquées sont ignorées à l’export et la numérotation reste continue.

Masquer vaut mieux que supprimer quand l’étape contient une capture utile pour plus tard, et mieux que la laisser quand elle embrouillerait le lecteur.

Une liste de vérification avant d’exporter

Questions fréquentes

Les titres d’étapes générés sont-ils modifiables ?

Oui. Cliquez sur le champ du titre sous le canevas et réécrivez-le. La description en dessous accepte du texte mis en forme, des listes et des liens, et les changements sont enregistrés avec le guide.

Quelle est la différence entre une sous-étape et un encadré ?

Une sous-étape fait partie de la séquence numérotée (N.1, N.2) et a généralement sa propre capture. Un encadré est un bloc Astuce, Avertissement ou Remarque non numéroté qui ajoute du contexte sans être une étape.

Les étapes masquées apparaissent-elles encore dans l’export ?

Non. Les étapes masquées sont ignorées et les étapes restantes renumérotées : le guide exporté reste continu. L’étape reste dans l’éditeur au cas où vous voudriez la récupérer.

Autres articles du blog