Affichage des articles dont le libellé est procédures. Afficher tous les articles
Affichage des articles dont le libellé est procédures. Afficher tous les articles

20/03/2014

Jeter aux orties les Vues d'ensemble et Introductions ?

Savez-vous ce que pensent les utilisateurs de vos sections "Vue d'ensemble", "Généralités" ou "Introduction" ?

RIEN ! Ils négligent, ils rejettent, ils ignorent... Ils ne lisent PAS toutes ces formes de préambules (les ingrats !)

Alors, pourquoi les inclure ? Pourquoi obliger les utilisateurs à feuilleter une dizaine de pages avant d'arriver à l'essentiel : "comment faire pour..."

Voici ce qu'en pense notre collègue Larry Kunz (extrait d'un message sur Twitter) :



Alors, si le consommateur n'a pas besoin d'une Vue d'Ensemble avant de commander une bière, est-ce que l'utilisateur a besoin d'une introduction avant d'utiliser le produit ?


Superfétatoire, l'introduction ?

Voici un exemple d'une introduction superfétatoire (il s'agit d'un manuel utilisateur d'un logiciel de création documentaire) :
Introduction
Ce guide est la documentation de la chaîne éditoriale XYZ. Elle regroupe :

  • Une introduction sur les fonctionnalité de XYZ et l'apport d'une chaîne éditoriale dans la rédaction des documents d'aide utilisateur d'un logiciel
  • Une présentation de l'interface utilisateur d'XYZ
  • Les procédures fondamentales d'utilisation de l'application
Donc, l'utilisateur a fait l'acquisition du produit XYZ. Normalement, à ce stade, il sait ce qu'il a acheté et a une certaine connaissance de ce qu'il peut faire avec ce produit. Avec le logiciel XYZ, il ne va pas chercher à faire du café ni à démontrer l'universalité de la théorie de la relativité...

Alors que le titre du manuel est "Documentation utilisateur de XYZ", est-il nécessaire de rappeler en page 8 : "Ce guide est la documentation utilisateur de..."

En introduction, on explique ensuite que, dans le manuel, il y a une introduction sur les fonctionnalités...  Introduction seulement ? Et le coeur des fonctionnalités, il est où ?


Présentation ... pour quoi faire ?

Après l'introduction à l'introduction, nous avons la  Présentation ... non pas du logiciel,
mais de l'interface. Intéressant. L'utilisateur a déjà l'écran en face de lui et maintenant on lui explique ce qu'il a devant les yeux. "L'option IMPRIMER sert à imprimer", "L'option EDITER sert à éditer", etc.

Sachant que les PC grand public sont arrivés en Europe dans les années '90, on est tenté de croire que, depuis le temps, l'utilisateur a assimilé les bases d'un travail avec l'interface.

Voyez ce qu'en pensent les spécialistes de l'ergonomie des interfaces graphiques :



Pour terminer, nous découvrons (enfin !) les procédures fondamentales (question de la béotienne que je suis  : quand elles ne sont pas fondamentales, les procédures, que sont-elles ?) ...et là, l'utilisateur est ébahi : dans un manuel utilisateur il trouve des PROCEDURES ! Quel bonheur !... c'est ce qu'il recherche depuis 15 minutes !


Le titre ...

Tout aussi édifiant, parfois, est le titre.

Ce grand industriel allemand, fabricant d'antennes de transmission sans fil par micro-ondes
(WiMAX) indique, en titre de son guide :"Safety precautions for User Guide". Oui, vous avez bien lu : "Précautions de sécurité pour le guide utilisateur".

... nous les professionnels de la rédaction le savons pertinemment : un manuel utilisateur est un OBJET DANGEREUX ! On ne peut travailler qu'avec moultes assurances-vie.

A votre avis, n'est-il pas temps de cesser de produire de l'information inutile et de revoir nos contenus ? 
________________________________
 
Le prochain atelier "Minimalisme : créer l'information dont on a vraiment besoin" aura lieu les 15-16 décembre 2014 à Vélizy (Paris) chez NMJ Services. Les inscriptions sont ouvertes !



26/12/2013

Ma documentation est de qualité !


Nul doute, puisque vous y avez apporté toute l'attention et les compétences nécessaires.

Par exemple, le formatage, la mise en page, le choix des caractères, l'outil d'aide à la rédaction, le correcteur orthographique (non, vous êtes au point et n'en avez pas besoin...), les notes des développeurs, le logiciel de capture d'écrans, l'outil de création graphique, etc.

Vous avez constitué votre équipe de rédaction et lui avez fourni un planning ? Bravo !


Votre Dream Team a travaillé d'arrache-pied en se délectant des nouvelles fonctionnalités du logiciel de mise en page.

Last but not least: vous avez faire relire l'ensemble du manuel par un "éditeur".

Tout est prêt pour la publication ? Champagne !...


Comment mesurer la qualité

En réalité, la qualité ne se  mesure pas exclusivement à la mise en page, évaluée par un membre de l'équipe de rédaction, mais sur des critères d'utilisabilité... effectués par l'utilisateur final !


Patatras ! L'utilisateur n'aime pas votre manuel... il ne peut pas s'en servir ; il ne lui sert à rien.
Vous avez investi 2 mois de travail pour 3 personnes et une semaine de révision qui se terminent par un rejet manifeste de la part du destinataire du manuel. Pas très brillant, n'est-ce pas ? Peut-on encore parler de qualité ?



Que vient faire le minimaliste dans ce scénario ?

Le minimalisme consiste à ne donner à l'utilisateur que l'information dont il a besoin pour accomplir une tâche. C'est à dire par exemple lui faciliter l'accès à l'information (principe n° 4).

Comment trouver rapidement l'information dont on a besoin ? 

A ce stade, le point crucial est la "Navigation" :


"This category highlights those aspects of a document that facilitate a reader’s ability to find relevant information. Is a logically grouped, easy-to-navigate table of contents provided, for accessing particular information?"
C'est pour cela que l'on fournira une table des matières, un index, mais aussi une rédaction
par rubriques (les fameux "Topics" sous DITA). Il n'est plus question de rédaction "waterfall" ou au fil de l'eau (Proust, James Joyce, Zola ne sont pas rédacteurs techniques...), mais de courtes procédures, très bien libellées et indépendantes.

Très bien libellées, cela signifie que le titre de votre rubrique doit être précis, "parlant" et correspondre à la terminologie de l'utilisateur.

Savoir naviguer et savoir éliminer !

Pour pouvoir naviguer, il faut permettre la circulation et donc éliminer les "bois flottés" qui entravent la recherche rapide.

Dans cet article  "Tips and Tricks: 10 Heuristics for Evaluating Documentation Usability"
on nous rappelle l'essentiel, c'est-à-dire élaguer et ôter ce qui n'est pas pertinent :
 "8. Minimalist writing
Topics should avoid information that is irrelevant. Every extra unit of information in a topic competes with the relevant information, which diminishes the findability of relevant information."

Effectivement, non seulement il est essentiel de travailler en (petites) rubriques , mais il est capital de ne pas NOYER l'information pertinente dans un marigot de bla-bla superflu.

C'est ce que nous démontre, très à propos, Gerry McGovern dans son article  "From managing inputs to managing outcomes" :

Customers want to know more in order to make better decisions. But the information must be easy to find and easy to understand."

Pour être de qualité, l'information doit être facilement accessible  et compréhensible... pas uniquement bien emballée !

Utile, efficace et sans paroles ?

Last but not least, voici un exemple patent d'une information utile, efficace et d'accès aisé. Il s'agit d'une video expliquant le montage d'un lit d'enfant. Aucun avertissement ("attention, l'utilisation d'un tournevis peut être dangeureuse !"), aucune note ("Le montage du lit doit être effectué par un professionnel dûment formé"), aucune "consigne de sécurité à lire absolument"... les instructions sont là, disponibles après 1 ou 2 clics et sans paroles !

Pour l'équipe de rédaction, il n'est plus question de taille de caractères, d'avant-propos, ni de traduction... puisque la video est sans paroles. Et pourtant, l'utilisateur trouve facilement l'information dont il a besoin pour monter le lit.

02/10/2013

Aéronautique & documentation minimaliste : go or no go ?

Dans le nucléaire, on peut appliquer sans hésitation les règles de la documentation minimaliste.

Soit, mais pas dans l'aéronautique, sacrebleu !


Pas besoin de minimalisme ? C'est à voir...

Ainsi, en 2005, AIR FRANCE, dans sa démarche pour "simplifier les procédures des équipages" a fait une refonte du "manuel d'exploitation" ... qui a été "complété, 3 semaines plus tard par deux cent cinquante-cinq (255) pages de mise à jour et de corrections"... 

Mais ce n'était pas du goût du porte-parole du Syndicat national des pilotes de ligne : 

"Quand vous avez une documentation pléthorique, des dizaines de pages superflues, les pilotes ne peuvent pas se reconnaître dans ce qui doit être le socle d'une culture commune"(*)

C'est là le coeur de la démarche minimaliste : ne donnez à l'utilisateur que l'information dont il a besoin. Pourquoi lui fournir une documentation volumineuse si elle n'est pas exploitable ? 
  

Du volume, sinon rien !

Ce même phénomène est relevé dans le rapport d'accident du vol TAM à l'atterrissage sur l'aéroport de Sao Paolo : 
"The A-320 manuals have lots of pages and are hard to consult,mainly during the flight"
Effectivement, ce n'est pas le volume de la documentation qui la rend utile, mais son accessibilité. Est-il facile d'obtenir l'information sur les "reversers" lorsqu'ils ne fonctionnent plus ? Combien de pages et de chapitres
feuilleter avant d'avoir exactement la procédure de secours ?

 

Très, très significatif également, le rapport d'accident du vol 1549 qui, après
décollage de La Guardia, a dû amerrir dans la baie de l'Hudson.   

L'excellent capitaine Sullenberger a suivi les procédures et, en duo avec le co-pilote, a pointé la "check-list".

Toutefois, heureusement qu'il ne soit pas allé jusqu'au bout des listes de pointage, parce qu'il aurait terminé sa course au fond de l'Hudson :

"However, according to post-accident interviews and CVR data, the flight crew did not complete this Checklist, which had 3 parts and was 3 pages long; although they were able to complete most of part 1, lack of time precluded starting Parts 2 and 3."
C'est là un des points-clés d'une formation au minimalisme : est-ce que la documentation est utile à l'utilisateur dans son environnement de travail   ?

C'est ce que Dr. Hans van der Meij appelle "Anchor the tool in the task domain". 


Terminologie ? un gadget négligeable !

 La terminologie... quantité négligeable aux yeux de certains.

En s'arrêtant sur la liste des rapports d'accidents et incidents publiée sur le
site de SkyBrary (initiative EUROCONTROL), on découvre, dans le rapport d'accident sur l'aéroport de Hambourg, un sérieux manquement en terminologie :

 "The terminology maximum crosswind demonstrated for landing was not defined in the Operating Manual and in the Flight Crew Operating Manual, and the description given was misleading“
Il semblerait que l'équipe de documentation ait oublié, ici, que la terminologie doit être CONSTANTE et COHERENTE !


Procédures ?... vous avez dit procédures ?

Non seulement les pilotes, mais les ATC (contrôleurs aériens) sont confrontés à une documentation défaillante. 

Ainsi, suite à un incident grave sur l'aéroport de Zurich-Kloten, les enquêteurs découvrent avec horreur que :

"the Zurich procedures contained no detailed description of how to manage simultaneous use of runways 16 and 28 for departures."
Le Bureau Fédéral de l'Aviation Civile Helvétique recommande donc que :

"the operator and users of Zurich airport should carry out a comprehensive analysis of the operating procedures and take all appropriate measures to reduce complexity and the systemic risks."
 Analyser les procédures pour suivre les actions à accomplir, analyser les
tâches de l'utilisateur et surtout mettre tout en oeuvre pour rendre le document clair et immédiatement utilisable, voilà les véritables mots d'ordre du rédacteur "minimaliste".


Produire de la documentation au kilomètre n'est PAS du digne d'un bon rédacteur technique ; mettre  toute son énergie pour fournir une documentation exploitable, immédiatement utilisable et sans ambiguité  est la caractéristique du rédacteur formé au minimalisme, celui qui ne donne que l'information dont on a besoin !
_____________________________
(*)  Extrait de "La face cachée d'Air France", 
p. 96--97, auteur : Fabrice Amedeo

15/07/2013

L' atelier "minimalisme et document procédural" en France : la FAQ


Pour 2015, si vous souhaitez co-organiser un atelier "Documentation minimaliste" en vos locaux, contactez les organisateurs. 

La FAQ du minimalisme


1. Le minimalisme, ça sert à quoi ?
Certainement pas à réduire la taille des mots ni à tronquer les phrases.
L'objectif est de donner à l'utilisateur (du produit et donc de la documentation) uniquement l'information dont il a besoin.  C'est le bla-bla, les considérations inutiles que l'on élimine, pas l'information utile.

Le minimalisme sert aussi à réduire le coût de l'infobésité



2. Le minimalisme ? Pas besoin de ça chez nous !

Une documentation "minimaliste" est utile et efficace, parce que _lue par les utilisateurs_.

...alors que la mauvaise documentation peut coûter 13,8 milliards de dollars par an !

Si vos clients vous retournent les produits, les utilisent très peu et très mal, ils ne vont pas, lors d'un autre achat, revenir vers votre catalogue !



Vos clients ont une bonne opinion de vos produits et de votre documentation. Ils n'en parlent pas comme ça, n'est-ce pas ? 






3. Rédiger pour le client du 21e siècle
Est-ce vraiment nécessaire, en entreprise, de rédiger la documentation  comme à l'époque de la machine à écrire mécanique ?

A votre avis, n'a-t-on pas progressé depuis les années 60 ? 


Avez-vous interrogé vos clients sur l'utilité des manuels et guides que vous fournissez ? 

Avez-vous une idée du temps passé par l'équipe du SAV à répondre aux appels des clients :

("Patron ?!! La hot-line est surchargée !!! C'est toujours les mêmes questions qui reviennent !...")
    Voici ce qu'en pense l'initiateur du site I Fix It :
"Guides and manuals have to be designed to be effective in the world we live today - not the world that we lived in 40 years ago.

It's the only way that documentation will ever get the respect and the attention it deserves".

4. Que produisent vos rédacteurs et à quel prix ?

Votre équipe de rédaction est en place depuis plusieurs années. Les rédacteurs connaissent bien vos produits.


Avez-vous pris le temps de vérifier l'utilisabilité de la documentation produite ?

Par exemple, le manuel utilisateur ne décrit pas en 10 lignes comment imprimer une page A4... 

Quelque chose comme :

IMPRIMER AVEC L'IMPRIMANTE ABC
L'imprimante ABC vous permet d'imprimer des feuilles au format A4.
Le format A4 est le format de lettre commerciale.


Pour imprimer avec l'imprimante ABC
- mettez l'imprimante sous tension
- sélectionnez la fonction "Imprimer" qui se trouve sur le menu
- tapez le nombre de feuilles à imprimer
- appuyez sur OK

Si l'imprimante ne fonctionne pas, éteignez et rallumez.
Sinon, appelez la hotline


...et ensuite vous faites traduire ce chef d'oeuvre de lapalissades en 28 langues ;-(((



5. Le minimalisme ne m'intéresse pas ; moi, je fais du DITA
Le minimalisme est indispensable à la rédaction sous DITA ("DITA authoring")
C'est exactement ce que pense Adobe.



6. Le minimalisme, c'est tout nouveau !
Jetez un oeil sur ce récapitulatif : Le minimalisme ça vient d'où ? 


Ce n'est pas vraiment récent, puisque le premier ouvrage "The Nurnberg Funnel" date de 1990 ! Depuis, les principes n'ont fait que se préciser et s'améliorer.

7. Une formation éligible au DIF ? Y ai-je droit ? Comment faire ?
Le Droit Individuel à la Formation, c'est pour vous. La preuve...  


Ce DIF en 10 points va également compléter votre information.


8. Un atelier ?... ça fonctionne comment ?

Pas question de cours magistral, pas d'apprentissage par coeur, pas d'entonnoir de Nurnberg...mais de l'action, voire de l'interaction. 


Pendant deux jours, le travail s'organise en petits groupes. A partir d'exemples concrets apportés par les participants, on met en application les principes du minimalisme. Résultat : chacun repart avec SA PROPRE DOCUMENTATION "minimalisée"!


9. Le minimalisme, c'est avec quel logiciel ?  Combien coûte-t-il ?

Le minimalisme n'est lié à aucun logiciel ; c'est le contenu et non pas l'outil documentaire qui importe. Quel que soit votre outil usuel (y compris la plume d'oie...) vous pouvez adopter et pratiquer la rédaction minimaliste. 

Lors de l'atelier, votre seul outil, ce sont vos cellules grises !



10. Le minimalisme est réservé à la documentation logicielle
 Idée tristement fausse. 

Dans son webinaire du 12 juin 2013, Dr. JoAnn Hackos a confirmé appliquer les règles du minimalisme à la documentation de matériel médical. 

Les ateliers précédents ont accueilli des participants du secteur forage et exploration pétrolière, gestion d'immeubles, tracteurs et machines agricoles, téléphonie, gestion de réseau internet, matériel médical, etc.

L'atelier se tient exclusivement en français, par un formateur francophone.



11. Faut-il faire l'acquisition de manuels d'apprentissage ?
 Ce n'est pas indispensable. Une bibliographie mise à jour vous sera remise lors de l'atelier.
 

Toutefois, vous repartirez avec votre support de cours -en français- et un recueil d'exercices et exemples en français.


12. Le minimalisme a vraiment été mis en place dites-vous ? Chez qui ?


Tous les grands noms s'y sont mis, sans hésitation !



 Avec la documentation minimaliste, les coûts de conception ne portent que sur le contenu UTILE et EFFICACE pour une utilisation satisfaisante du produit.
 L'utilisateur n'ouvre jamais le manuel... sauf quand il a besoin d'une information précise. La trouve-t-il vraiment et rapidement dans votre documentation ?

 Savez-vous qu'un rédacteur non formé est plus coûteux qu'un véritable rédacteur professionnel ? 

L'amateur rédige pour le plaisir de rédiger (façon romancier) et produit des romans-fleuves inexploitables. Le professionnel rédige pour satisfaire aux attentes de l'utilisateur : il pense ergonomie, économie et utilisabilité !

En formant vos collaborateurs au minimalisme, non seulement vous les fidélisez, mais vous les préparez à la documentation sous DITA et à la rédaction en mode 'agile'
 A quoi peut servir un budget formation, sinon à former les collaborateurs pour les rendre plus compétitifs, à l'image de votre entreprise ?

 Se former en petits groupes, à partir d'exemples concrets, est-ce que ce n'est pas 
la solution optimale ?


Un manuel rédigé selon les règles du minimalisme a 90 % plus de chances d'être lu et utilisé qu'un manuel ("pavé") à l'ancienne !
 A votre avis, est-ce que vos concurrents ou vos sous-traitants ne sont pas en train de se former, eux, au minimalisme ?