Minimalisme Archives

Catégorie : Minimalisme

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 …

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 …

Minimalism authoring: some resources

“The essence of the minimalist approach is to obstruct as little as possible the learner’s selfinitiated efforts to find meaning in the activities of learning.” (John M. Carroll) Basics by John M. Carroll and Hans van der Meij Minimalism Beyond the Nurnberg Funnel First Minimalist Manual Minimalism principles Applications An application of the Principles of Minimalism… Lire la suite …

Grammaire, conjugaison, phraséologie… Quel ennui !

Dans un raccourci fulgurant, certains rédacteurs pensent qu’en implémentant les règles du minimalisme, ils peuvent passer rapidement sur ces scories que sont les règles degrammaire, de conjugaison et autre horreurs comme l’orthographe. Puisque le minimalisme cherche à éliminer le superflu, éliminons les rigidités grammaticales ! La conjugaison ? quelle abomination ! Et pourtant, parmi les… Lire la suite …

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

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

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

Utilisateurs stupides et rédacteurs idiots ?

Les utilisateurs sont stupides ? Dans son article, Stephen Turbek pense surtout qu’il sont « Stressed, Tired, Untrained, Passive, Independent, Distracted ».Oui, mais comment concevoir une documentation pour ce genre d’utilisateurs ?________________________La documentation du 21e siècle ? Dans son article « The power of free manuals« , Kyle Wiens conclut en recommandant : « Rethinking documentation – …Manual and guides… Lire la suite …

Minimalisme : les Dix Commandements

A mon humble avis, ceci est à mettre au-dessus de tout poste de travail d’un rédacteur technique : 1. Minimalist writing means including the least amount of content that is necessary for user success.2. New users aren’t interested in concepts.They want to jump in and try the product. 3. Minimalist writing means not offending the user’s… Lire la suite …

Les idées fausses sur le minimalisme

Documentation figée ? Dans un article bien détaillé, Joe Pairman reprend les points avancés par Mark Baker qui, lui, prétend que le minimalisme conduit à une documentation inerte ou figée. La discussion se déroule sous forme de duel très, très webien qui vaut vraiment plusieurs minutes de notre attention. Première salve : le rédacteur ajoute-t-il… Lire la suite …