Écrire l'introduction en dernier

Voilà un fait qui peut vous paraître étonnant ! Mais oui, personnellement j'écris l'introduction toujours à la fin de la rédaction.

L'introduction dans un livre joue le même rôle que le chapô en presse : c'est lui qui va donner l'envie de lire le livre, de lire l'article en presse
C'est donc quand j'ai terminé de rédiger le livre que j'ai enfin une bonne vision globale de ce qu'il va apporter au lecteur. Je peux comprendre dans son ensemble ce que va acquérir le lecteur. À la fin de la rédaction, je sais ce que j'ai écrit, comment je l'ai écrit, ce que va gagner le lecteur en lisant l'ouvrage. À ce moment-là je peux écrire une introduction qui va inciter le lecteur à acheter le livre.
Si vous écrivez l'introduction dès le début de la rédaction, vous n'avez pas encore l'orientation rédactionnelle précise du livre, vous n'avez pas encore le "fil rouge". Vous ne savez pas encore comment vous allez amener le lecteur là où vous souhaitez aller.

Donc comme en presse pour le chapô, essayez de rédiger vos introductions en dernier.

Un verbe d'action dans les titres

Un chapitre d'un livre est structuré en paragraphes. Chaque paragraphe est annoncé par un titre. Nous allons maintenant évoquer contenu des titres. Nous avons déjà évoqué l'importance des titres et leurs différents types dans un article précédent.

Il me semble très intéressant de placer un verbe d'action dans les titres. Cela va permettre de donner du dynamisme au titre. L'objectif étant de donner au lecteur l'envie de lire le paragraphe. Il faut donc éviter une forme passive, voire ennuyeuse. Nous devons indiquer ce qui va se passer dans le texte qui va suivre en plaçant un verbe d'action.

Par exemple évitons d'écrire : "Le paramétrage du nouveau document", mais plutôt "Paramétrer le nouveau document".
Utiliser un verbe d'action à l'infinitif implique beaucoup plus le lecteur, il se sent forcément concerné, il va devoir agir, réaliser une action. Personne d'autre que lui va devoir passer à l'action.
De plus, commencer tout de suite par le verbe, permet d'entrer immédiatement dans le vif du sujet, au cœur de l'action, vous interpellez sur-le-champ le lecteur.

Faire des phrases simples et courtes

L'écriture dans un livre informatique pédagogique doit être réalisée avec des phrases courtes et simples. Cela rejoint l'écriture pour le web. Plus les phrases sont longues alambiquées, plus l'utilisateur sera gêné et il devra alors relire une fois, deux fois la phrase avant de la comprendre. Tout cela nuit à la compréhension rapide d'un texte.

Voilà un exemple d'une phrase un peu trop complexe à mon goût, extraite d'un livre sur l'utilisation du logiciel Adobe Dreamweaver. C'est une explication sur la façon d'annuler l'application d'un style CSS :
"Pour annuler l'application d'un style, sélectionnez l'élément qui utilise ce style puis choisissez Format - Styles CSS - Aucun ou dans le menu déroulant Règle cible (ou Classe) du panneau Propriétés, cliquez sur Supprimer la classe ou dans le menu déroulant Classe cliquez sur Aucune".
Ouf ! Maintenant vous pouvez respirer !

Alors analysons cette phrase.

- Cette phrase comporte 46 mots ! C'est beaucoup trop. Pour moi, il faut compter 20-25 mots par phrase.

- La phrase contient trois fois le mot ou. C'est un indicateur très précis d'une phrase trop longue. A partir du moment où vous utilisez plusieurs fois le mot "ou", cela doit être un indicateur pour vous dire "Ma phrase est trop longue. Est-ce que je peux en faire plusieurs à chaque utilisation du mot ou". J'ajoute que l'utilisation du mot "puis", dans ce contexte, donne le même effet que le mot "ou".

- Le rédacteur écrit : "Règle cible (ou Classe)". Là c'est une erreur pédagogique. De quoi parle-t-on ? D'une Règle cible ou d'une Classe ? Cela ne peut pas être les deux en même temps. Si c'est l'un ou l'autre, il faut alors en expliquer le contexte d'utilisation : quand devons-nous utiliser une Règle cible ou une Classe ? A la lecture de cette phrase l'utilisateur est incapable de savoir quand il doit passer par Règle cible ou Classe.

- Puis nous lisons ensuite que cela ce passe dans le panneau Propriétés. Il eut fallut le dire avant ! Il faut toujours situer l'environnement d'utilisation avant de parler d'un élément d'interface de cet environnement (voir l'article Le chemin d'accès aux éléments d'interface).

Voilà ce que je propose comme correction :
"Pour annuler l'application d'un style, sélectionnez l'élément qui utilise ce style. Dans le panneau Propriétés, avec le bouton CSS actif, dans la liste déroulante Règle cible, choisissez Supprimer la classe. Toujours dans le panneau Propriétés, avec le bouton HTML actif, dans la liste déroulante Classe, choisissez Aucune."
J'ai ainsi trois phrases de 14, 19 et 17 mots.
Je n'ai pas utilisé les mots "ou" et "puis".
J'ai bien indiqué d'abord l'environnement dans le quel le lecteur va trouver les éléments décrits : le panneau Propriétés et après les éléments d'interface de ce panneau.
J'ai bien indiqué le contexte d'utilisation des deux possibilités pour annuler le style : avec le bouton CSS ou avec le bouton HTML actif.

Rappel à une fonction, une option

Dans une page constituée de plusieurs paragraphes, le rédacteur peut évoquer plusieurs fois une fonction, une commande, une option donnée.

A la première évocation de cette fonction, il faut clairement la décrire et correctement la nommer, avec le même nom que dans l'application, le logiciel étudié.

Quand nous devons de nouveau évoquer cette fonction, il faut impérativement la nommer de la même façon que la première fois. Il ne faut surtout pas mettre en difficulté le lecteur en changeant son nom.

De plus, nous ne devons pas l'évoquer en utilisant un mot "passe-partout" dénué de sens, type : "cette option", "cette fonction" ou "cette commande". Le lecteur ne pourra pas facilement faire le lien entre ces mots "passe-partout" et le nom de la fonction que nous souhaitons évoquer de nouveau.

Il faut toujours faire appel à une fonction en l'évoquant par son nom utilisé dans l'application.

Même mot pour la même action

A la rédaction d'un livre, il faut bien faire attention à toujours utiliser le même mot pour la même action.

Je vais prendre un exemple bien concret que j'ai déjà vu dans un (des) livre(s) : le mot choisi pour désigner l'action d'utilisation d'un item d'un menu. Dans le même ouvrage, j'ai noté tous ces mots :

• choisir,
• cliquer,
• sélectionner,
• pointer,
• activer.

Soit cinq mots différents pour la même action ! Cela nuit à compréhension de ce qu'il y a à faire. Pourquoi utiliser cinq mots différents pour la même action ? Quelle est la justification de ce manque flagrant d'homogénéité ? Le lecteur débutant peut facilement se perdre.

Donc soyons clairs : utilisez le même mot pour la même action. Vous gagnerez en simplicité et en compréhension pour vos lecteurs.