documentation minimaliste Archives

Catégorie : documentation minimaliste

Section « Troubleshooting » …Comment faire ?

Un chapitre « Troubleshooting » dans ma documentation ? Reprise sur erreur avez-vous dit ?… C’est le principe n° 3 du minimalisme : « Support error recognition and recovery ». Il s’agit d’aider l’utilisateur à retomber sur ses pieds, alors qu’il a fait une erreur. Pour faciliter le retour sur la bonne voie, le rédacteur a deux options: donner… Lire la suite …

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… Lire la suite …

Minimalisme: principe n° 2 « L’outil intégré dans la tâche »

Oui, mais, … qu’est-ce que cela veut dire au moment de la conception de la documentation ? Anchor the tool in the task domain Disons : « l‘outil doit être considéré par rapport à la tâche » Dr. Hans van der Meij nous l’explique : « For most users, an application is a tool they want to use to achieve… Lire la suite …

La documentation minimaliste ?… un mauvais plan !

La documentation dite minimaliste ne m’intéresse pas parce que : je n’y connais rien ça n’a pas été inventé chez nous c’est du mauvais travail. Il faut TOUT dire à l’utilisateur mon boss ADORE les gros manuels. Je suis payé à la page… le département de documentation n’a pas de problèmes de budget les utilisateurs… Lire la suite …

Minimalisme ? pas chez nous !

« Nous fournissons un travail sérieux, nous ! Nous ne rechignons pas devant l’ampleur de la tâche : nous fournissons la totalité de l’information ! Un travail vraiment complet… sinon rien !Le minimalisme est réservé aux rédacteurs à mi-temps, ceux qui veulent un travail « quick and dirty » ! Alors, vous préférez l’infobésité ? …disons un beau… Lire la suite …

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 :… Lire la suite …

Booster l’efficacité de votre documentation !

Vous souhaitez actualiser, au sein d’un groupe de collègues, votre savoir-faire pour optimiser votre documentation produits en créant une documentation ciblée utilisateur et structurée ? Faites-le savoir ! N’hésitez pas à vous joindre aux discussions sur le démarrage d’un projet de documentation, son volume, son coût, son utilité et le feedback de vos utilisateurs. Avant-goût… Lire la suite …

Le minimalisme expliqué par un Ch’ti (*)

Qui ici a lu une fois dans sa vie un mode d’emploi en entier ? C’est la question posée par l’acteur Dany Boon dans son interview d’un éminent rédacteur technique. L’acteur compatissant analyse avec le rédacteur technique (au bord du désespoir : 60 ans de rédaction et personne n’a jamais lu un seul manuel en… Lire la suite …

Documentation minimaliste ?… pas dans le nucléaire !

Sûreté de fonctionnement : gros pavé ? Pour garantir la sûreté d’utilisation et de fonctionnement dans le domaine du nucléaire, il faut une documentation volumineuse, coûteuse et conçue par des ingénieurs dans un format établi et immuable. C’est à ce prix que l’on contribue à la qualité d’utilisation des outils, machines et mécaniques… non ?… Lire la suite …

A quoi sert le manuel ?… à écraser les moustiques !

Dans un twitt récent, un utilisateur anglophone ouvre de nouvelles perspectives quant à l’utilité de manuels utilisateurs …Il a donc utilisé un gros manuel pour écraser le moustique qui l’agaçait. Il s’agit d’un lourd manuel accompagnant une montre… L’auteur avait pourtant d’autres méthodes pour se débarrasser de l’intrus ! Mais au fait, a-t-il vraiment eu… Lire la suite …