Français · How-to guide

Un guide pratique en français qu'on peut suivre pour de vrai

L'écriture instructive n'a qu'une mesure de qualité : est-ce que le lecteur sait le faire après. Tout le reste en découle.

Partez d'où le lecteur se trouve

Écrivez trois choses et gardez-les sous les yeux : ce qu'il sait déjà faire, ce qu'il a sous la main, et à quoi ressemble « fini » — un résultat concret, pas une sensation. « Un pain à la mie ouverte », pas « la confiance de savoir cuisiner ».

Analysez la tâche avant d'écrire

Listez toutes les actions dans l'ordre, y compris celles qui vous paraissent évidentes : c'est exactement là que le débutant se bloque. Pour chacune, notez ce qu'il faut avant, ce qu'elle fait, comment il sait que c'est réussi, et ce qui rate le plus souvent.

Comment s'écrit une étape

• Une action par étape. S'il y a un « et », ce sont probablement deux étapes.
• Commencez par le verbe : « Ouvrez le fichier », pas « Vous allez vouloir ouvrir le fichier ».
• La condition d'abord : « Si la pâte colle, ajoutez de la farine ».
• Un point de contrôle à la fin : comment il voit que c'est bon avant de continuer.

Les erreurs valent des chapitres

Ce que les lecteurs retiennent d'un guide, ce sont les pièges. Pour chaque étape délicate : ce qui rate, à quoi ça ressemble quand c'est raté, et comment rattraper. Un guide qui dit seulement ce qu'il faut faire est une notice ; un guide qui dit ce qui va mal est un livre.

Ce que ça coûte

Écrire et lire les premiers chapitres est gratuit. Le livre entier, avec les fichiers EPUB, PDF imprimable, DOCX et Markdown, coûte 9 $ une seule fois.

Questions fréquentes