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èdeComme 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

    Laisser un commentaire ?

    Anti-spam *

    ERIKSON
    GSX
    COHERIS
    SCHLUM
    EFFICIENT
    OPTIS
    INTERSEC
    NMJ
    TALEND
    LYRA
    HILL
    HORIBA
    ERIKSON
    GSX
    COHERIS
    SCHLUM
    EFFICIENT
    OPTIS
    INTERSEC
    NMJ
    TALEND
    LYRA
    HILL
    HORIBA

    logo-bleu

    Établissement de formation à la documentation technique

    Formatrice : Marie-Louise Flacke

    Graduate of the American
    University of Paris
    Tel. 06 03 20 50 10

    … mais que signifie Awel-A-Ben ?

    Contact

    BLOG

    blog-icon

     

    PRESS

    press-icon