Utiliser mon DIF pour un atelier "Documentation minimaliste" ?

 ... Non, mais et puis quoi encore ?

  _______________________________________

Quel contenu ?

• D'abord, que contient un atelier "minimalisme et documentation"  et où trouver un exemple de ré-écriture en version "minimaliste"

• Au cours de l'atelier, vous vous familiarisez avec les 4 principes du minimalisme, puis vous les mettez en application à partir de VOTRE documentation. Vous pouvez repartir avec vos propres documents retravaillés !

_______________________________________

 Quels destinataires ?

• Mais un atelier, est-ce vraiment pour nous ? 

• L'atelier est destiné à tout rédacteur/manager vraiment désireux de fournir (enfin !) l'information utile (... et peut-être cesser d'être la risée des utilisateurs qui n'aiment pas qu'on les prenne pour des handicapés du bulbe !)

_______________________________________

Quelle difficulté ?

• Le minimalisme est difficile à comprendre et mettre en application.

Par exemple, que couvre le principe numéro 2 ("Anchor the tool in the task domain") ?

• Le minimalisme a été développé par des professionnels de l'analyse du comportement des utilisateurs. En atelier, nous clarifions et mettons en application le résultat de cette analyse.

_______________________________________

 Quelle finalité ?

• Le minimalisme contre l'infobésité : qu'y a-t-il de vrai là-dedans ?

•  Que penser de ces collègues spécialisés dans la documentation disponible "Any time, Anywhere, On any device" ? Pas question, dans ce cas, de fournir 28 pages d'avertissements à lire sur des Goggle Glass !

_______________________________________

 Que rejeter ?

• Il est question de décimer les "Introductions" et "Vues d'ensemble"... 

Eliminer ? Ciel ! Est-ce vraiment nécessaire ?

• L'utilisateur n'a pas besoin de trouver, dans un manuel, ce qu'il sait déjà : que sa tondeuse sert à couper le gazon et qu'une lame bien acérée peut couper un doigt de pied !

• Un Ch'ti est-il vraiment capable de démontrer la pertinence du minimalisme ? 

•  OUI ! Dany Boon l'a fait !... et ce n'est pas à la gloire du rédacteur ;-)

_______________________________________

 Où s'informer ?

•  Le minimalisme a sa FAQ et je voudrais bien la voir, sa foire (aux questions) !

• Si une information vous manque, n'hésitez pas à contacter [flacke [at] orange.fr]

_______________________________________

 Quels coûts ?

• Le coût de l'infobésité et le coût de VOTRE documentation : 

95 heures de travail perdues par employé et par an...

• Avez-vous pris le temps d'estimer le coût de votre documentation ? Vous pouvez démarrer avec ces critères.

•  En parlant de coûts, comment assurer une prise en charge des coûts de formation par le DIF?

  _______________________________________

 Quels commentaires ?

• Oui, mais, qu'en pensent les participants ?

Combien d'argent ai-je jeté par les fenêtres aujourd'hui ?

En matière de documentation produits, voici trois pistes pour brasser de l'air et dépenser à tour de bras :

• produire un Pdf de 400 pages que personne ne lit
• noircir 180 pages pour décrire les fonctionnalités du produit, en incluant 2 copies d'écran par page, dont plusieurs affichent le bouton OK. Ou alors préciser que l'onglet d'annotation sert à afficher le document annoté !

passer 4 h 45 à rédiger le chapitre "Généralités" ... que l'utilisateur ne va pas lire.

__________________________________________
Suzie-la-Terreur
Et voici Suzie-La-Terreur (terreur des équipes de rédaction) pour qui la documentation

technique, c'est comme l'oie que l'on promène dans les rues de New York : décalée, rutilante, humoristique, hors contexte, futile... risible !

Son manuel sur papier glacé est futile, décalé, risible et inutile parce qu'il ne répond pas aux questions précises telle que "comment faire pour modifier les paramètres sans perdre mes enregistrements précédents" que se pose l'utilisateur.

Par contre, ledit manuel se contente de ressasser les évidences. Sous Software Update, il est effectivement impératif d'ajouter qu'il faut avoir installé la version précédente avant de mettre à jour !

Aucune raison  de se pavaner dans les salles de réunion avec le manuel de 450 pages  si l'utilisateur s'en sert comme rehausseur de siège !

Bien sûr, Suzie-et-son-oie-à-New-York (Photo de Ruth Jacobi, 1928) nous plaisent beaucoup  : elles feraient un excellent fond d'écran . 
__________________________________________
Suzie-la-dispendieuse
Transposée dans le monde de la rédaction technique, Suzie ne génère qu'une chose : REJET ! Cette documentation est coûteuse parce qu'inexploitable : aucun utilisateur ne va y trouver rapidement la réponse à sa question.  Ce faisant, Suzie a tout fait pour détruire l'image du métier et confirmer que la documentation ne sert à rien, sauf à générer des coûts inutiles !
 En cela, elle se rapproche du rédacteur de Dany Boon (celui qui explique en 5 langues comment démarrer le micro-ondes)
___________________________________________

Comment s'en sortir ? Où est l'alternative ?

Ne donner à l'utilisateur que ce dont il a besoin !... c'est la base du "Minimalism: creating information people really need"



Il s'agit d'une formation exclusivement basée  sur la _pratique_: vous apportez vos
documents et vous repartez avec VOTRE DOCUMENTATION passée au crible du minimalisme.

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

Atelier Minimalisme et Documentation

Savez-vous qu'une documentation "minimaliste" a 90 % plus de chances d'être lue et utilisée qu'une documentation traditionnelle...

Vous êtes-vous demandé combien de pages est-ce que l'utilisateur de votre documentation doit parcourir avant de trouver la solution à son problème ?

 ...N'est-ce pas le moment de passer à l'optimisation de la documentation par le truchement du minimalisme ?

Le succès du minimalisme

Vous voulez en savoir plus sur le minimalisme? Jetez un oeil sur cet article What makes minimalism so popular today?

Inscription
Un dernier mot : ces ateliers seront entièrement en français (sauf à Liège Seraing) ! Une première en France !...  Pour tout complément d'information, pensez au contact direct avec l'équipe de formation.