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
(WiMAXindique, 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 !



12/03/2014

Booster l'efficacité de votre documentation !

Vous souhaitez actualiser, autour d'un café-palmiers, votre savoir-faire pour optimiser votre documentation produits en passant au minimalisme !


 Faites-le savoir !

Topic : au centre des discussions, le volume de la documentation, son coût, son utilité et le feedback de vos utilisateurs.

Avant-goût : la documentation minimaliste et structurée ne s'applique pas à votre domaine ? ... Jetez un oeil sur ces exemples :

- Transformation d'une documentation-fleuve en une documentation structurée 
- Passage d'une documentation romancée à une documentation minimaliste (enfin  !)


____________________________________________

Pour en parler, faites-nous signe !
____________________________________________

Vous n'avez pas besoin de passer votre documentation à la grille du minimalisme ? C'est ce que pensaient les rédacteurs du site nucléaire Three-Mile-Island.

Selon l'émission Planète Terre, dans la salle de contrôle du site nucléaire, au moment de la catastrophe et alors que tous les voyants étaient au rouge, les ingénieurs devaient lire un manuel de 150 pages ! ... malaise, vous avez dit malaise ?
________________________________________________

Le prochain atelier "Minimalisme : créer l'information dont on a vraiment besoin" aura lieu les 15-16 décembre 2014 à Vélizy (Paris) et se tiendra en français. Les inscriptions sont ouvertes !

07/03/2014

Minimalisme, qualité et lisibilité (...foutaises ?)

En parlant minimalisme, on entend souvent : c'est réduire la longueur des mots !


Et bien non, ce n'est absolument pas cela. Tous les mots, à partir du moment où ils sont compris et utilisés par l'utilisateur final sont utilisables dans une documentation technique.

En matière de longueur des mots, quelques esprits qui s'autorisent à penser pour les autres, nous recommandent l'emploi de tests de lisibilité pour mesurer la qualité de la documentation technique. Vous savez, les tests de Flesch-Kincaid, Fog, etc.

On dispose même d'outils disponibles en ligne qui "calculent" le taux de lisibilité d'un document. Amusant, non ? Pour la langue française, choisissez (sous "Method") l'option  Kandel & Moles.

______________________________________________________________________________

Malheureusement, ces petits joujoux ne résistent pas à un examen un peu approfondi

  En effet, les tests sont basés sur 2 critères : 
  • la longueur des phrases 
  • la longueur des mots. 

Plus le mot est long, plus il est considéré comme "difficile" à comprendre. Comme l'indique
le Prof. Franck Ganier :
"... plus les phrases sont longues et le vocabulaire complexe, moins le texte est "lisible"  .

Soit, mais en y regardant de plus près, selon  F. Ganier (*) :
"si l'on considère que ces formules ont été créées à l'origine pour déterminer le niveau de lecture correspondant  à des textes écrits pour des manuels scolaires, on peut s'interroger sur la pertinence et la validité de leur usage pour l'évaluation de documents techniques". 

Erreur d'aiguillage, donc. C'est applicable aux manuels scolaires et pas transposable en rédaction technique.


De plus, ces tests n'ont été conçus que pour la langue anglaise, qui a une bien autre structure que le français ! Le test de Kandel et Moles n'est qu'une (piètre) adaptation.

Par ailleurs, Ginny Redish, dans un article datant des années '80 (**)   descend en flammes la pertinence de ces tests :

"A formula that counts only sentence length and word length or familiarity of the words is not sensitive to the order of the words or the complexity of the grammar. Sentences with misplaced clauses, dangling participles, or misused words will score as well on a readability formula as sentences of equal length that have none of these problems".
_____________________________________________________________________________

Gadgets ?

Nous voilà en présence de gadgets puisque ces "tests" ne tiennent compte que de la longueur des mots, mais pas de leur position dans la phrase...

In fine, prenons un exemple : le terme "excipients" doit être considéré comme simple à comprendre puisqu'il ne dépasse pas les 3 syllabes en français.  Par contre, le terme

"électrocardiogramme", qui en compte 6, sera estampillé _difficile_. Or, dans la réalité, demandez à un quidam ce qu'il entend par "excipients" et par "électrocardiogramme"...Ce n'est certainement pas le plus long qui pose problème !

Alors, en conclusion, on ne va pas inclure, dans notre projet d'évaluation de la qualité de la documentation minimaliste, de tests de lisibilité... sauf pour s'amuser.

Et l'on ne va pas passer notre temps à raccourcir les mots pour faire plaisir  à Messieurs Flesch et Kincaid !



 ____________________________________________________________________________
(*) "Evaluer l'efficacité des documents techniques procéduraux: un panorama des méthodes", PUF, Le Travail humain, 2002/1, Vol.65
(**) "Understanding the limitations of readability formulas", in IEEE Transactions on professional communication, 1981,vol. 2

Voir aussi: "Comprendre la documentation technique", Franck Ganier, Editions PUF