Vous écrivez un bel article en restant sobre : un texte bien découpé, et des blocs riches avec parcimonie. Le lecteur, personne ou IA, y trouve sa réponse en quelques secondes. Ouvrez par la réponse, découpez avec des titres, et retirez tout ce qui ne sert pas.
Le contenu est le même des deux côtés. À gauche, le lecteur lit tout pour trouver sa première action. À droite, il la voit en deux secondes, avec seulement deux blocs riches : un encadré et des étapes. Le reste est du texte et une liste.
Les six règles d'un bel article
Ouvrez par la réponse, puis détaillez. La première phrase dit ce que le lecteur va pouvoir faire : « Vous reliez Gmail ou Outlook à Mindsay en deux étapes. » Chaque section répond à la question que la précédente fait naître.
Découpez avec des titres qui renseignent. Un titre tous les 150 mots au plus, court, avec un verbe : « Connecter la boîte », pas « Généralités ». Lus à la suite, les titres racontent la page.
Une action, une ligne. Un verbe, ce qu'on clique en gras, ce qu'on voit ensuite : « Cliquez sur Paramètres. La liste des fournisseurs s'affiche. »
Le texte d'abord, les blocs riches avec parcimonie. Écrivez des paragraphes de une à trois phrases, des listes, des tableaux. Un bloc riche (encadré, étapes, onglets, bloc repliable, cartes, bouton) se justifie quand le texte ne suffit pas : trois par page, en règle générale.
Une image seulement si elle explique plus vite que le texte. Placez-la juste après l'instruction qu'elle illustre.
Écrivez aussi pour les IA. Voir la section suivante.
Écrire pour les personnes et pour les IA
Vos articles sont lus par des personnes, mais aussi par des IA : l'assistant IA de Mindsay et vos bots. Une IA lit le texte de l'article, pas ses images, et parfois un seul morceau de la page. Appliquez ces six habitudes :
Dites en texte ce que montre l'image : une phrase avant ou après, et un texte alternatif qui la décrit.
Jamais une information importante seulement dans une image : nom de bouton, chiffre, étape.
Un tableau plutôt qu'un schéma pour des chiffres : le texte d'un tableau se lit, celui d'un schéma non.
Chaque section se comprend seule : redites le nom de la fonction plutôt que « elle ».
Des chiffres exacts : « 5 minutes », pas « quelques minutes ».
L'essentiel en texte visible : ne cachez pas la réponse dans une définition au survol ou un bloc HTML.
Quand un bloc riche vaut la peine
Par défaut, écrivez un paragraphe ou une liste. Passez à un bloc riche seulement si le besoin ci-dessous est réel. Tapez / sur une ligne vide pour ouvrir le menu des blocs.
Vous voulez… | Utilisez… |
|---|---|
Guider une procédure | Des étapes : un titre court, une action |
Prévenir d'un risque, donner un conseil | Un encadré |
Présenter des variantes (Gmail ou Outlook) | Des onglets |
Répondre aux questions annexes | Un bloc repliable |
Pointer vers la suite | Un bouton, ou des cartes |
Donner une commande à copier | Un bloc de code |
Une liste, un tableau ou une image ne sont pas des blocs riches : utilisez-les librement. Les vingt blocs et leurs réglages sont décrits dans la page Le format d'un article de la documentation de l'API Mindsay.
Un plan pour chaque type de page
Gardez toujours le même ordre : le lecteur sait où trouver chaque chose.
Type de page | Plan, dans l'ordre |
|---|---|
Procédure (« Connecter votre boîte mail ») | Une phrase qui dit le résultat, Avant de commencer, les étapes, Vérifier que ça marche, Si ça ne marche pas (une courte liste) |
Explication (« Comprendre le score ») | La valeur en une phrase, une image, un tableau des réglages, les limites |
Dépannage (« Le widget n'apparaît pas ») | Le symptôme en une phrase, puis une cause par bloc repliable, de la plus fréquente à la plus rare |
Référence (« Les droits d'une clé ») | La définition en gras, un tableau, un exemple dans un bloc de code |
Relire avant de publier
Chaque point doit être vrai :
La première phrase dit ce que le lecteur va pouvoir faire.
Aucun passage de plus de 150 mots n'est sans titre, et aucun paragraphe ne dépasse 60 mots.
Lus à la suite, les titres racontent la page, et chaque lien nomme sa destination (« les droits d'une clé », pas « cliquez ici »).
Chaque image a un texte alternatif, et ce qu'elle montre est aussi écrit dans l'article.
Les blocs riches sont là parce que le texte seul ne suffisait pas (trois par page en règle générale, dont deux encadrés au plus, chacun avec une seule idée).
La page finit par un lien vers l'article à lire ensuite, et vous n'avez rien laissé qui ne serve pas le lecteur.