Combien de glu dans votre manuel ?

Lors de ses ateliers, JoAnn Hackos recommande d'éliminer la "glu" dans les documents utilisateurs...

Mais où trouve-t-on cette glu ?

Dans un article publié sur le site DITA.xml.org, JoAnn lance le débat sur la colle qui, justement, colle de trop dans les manuels.


Elle entend par là les portions de texte de transition qui remplissent les pages sans apporter d'information utile à l'utilisateur.

Le texte-colle ?
C'est cette portion qui doit servir à informer l'utilisateur de ce qui va suivre ou de ce qui précède. Comme dans un roman ou dans un feuilleton.

Or, en documentation technique, nous intervenons sur plusieurs formes de communication, mais surtout pas sur le roman !


Chacun son métier : le romancier brode, déroule du texte, introduit de l'affect dans ses écrits, fait jouer les sonorités de la langue, devient poétique... mais ne sait pas comment expliquer, en 8 étapes, comment changer la roue du camion !

Disons que Marcel Proust aurait fait un piètre rédacteur technique...

Mais où est-elle cette glu ?

"In this chapter, you will learn the following:
• How to make a call
• How to answer a call
• How to set up your list of contacts and phone numbers
...and so on."

Cette portion est destinée à annoncer les sections qui suivent, c'est bien gentil, mais est-ce que l'utilisateur a vraiment besoin de cette mise en scène, alors qu'il veut rapidement trouver la réponse à sa question : "comment constituer une liste de correspondants ?"
 
De même, on parle de "colle" en fin de section/chapitre dans l'exemple suivant :

"We have completed the discussion of making a call. Now, we will proceed with the second discussion, that of answering a call".

Cela suppose que l'utilisateur est confortablement installé dans son fauteuil en lisant le manuel de bout en bout et se délectant des instructions numérotées.

Mais sommes-nous près de la réalité ?
  Probablement pas...

L'utilisateur aura ouvert le manuel à contre-coeur, parce qu'il n'aura pas trouvé la solution tout seul.
Il se sera résigné à feuilleter le manuel. 
 
Il ne veut pas le LIRE, il veut la réponse à sa question.

Et que penser de cet autre exemple de "colle" :  

 

Paramétrer votre imprimante 

 Pour paramétrer votre imprimante : 

 1. allumer l'imprimante  

 2. dans la fenêtre "Paramètres", sélectionnez XYZ.

 3. XXX

En réalité, l'utilisateur ne veut qu'une réponse :

     Paramétrer votre imprimante

• Sélectionnez Menu-->Paramètres