Moi et plusieurs autres membres de JMP récemment assisté à un Minimalisme atelier pour écrivains et rédacteurs présenté par Services ComTech . L'atelier s'est concentré sur la réduction de la quantité de contenu écrit qui peut être trop volumineux ou détaillé sans affecter la qualité.
Minimalism, conçu par John M. Carroll du Centre de recherche Watson d’IBM, est centré sur l’apprentissage basé sur le texte qui encourage l’exploration plutôt que l’apprentissage par le rôle. La théorie minimaliste propose d'amener les utilisateurs immédiatement, de minimiser la lecture et de les amener à combler eux-mêmes les lacunes. Donc, documentation minimaliste contient souvent des procédures avec peu ou pas d'introduction et d'explication. L'idée est d'inclure un contenu orienté vers l'action, utile et bien adapté à la tâche. Le minimalisme met en avant le contenu le plus important et minimise les distractions pour l'utilisateur.
Les quatre grands principes sont les suivants:
• Incorporer une approche orientée vers l'action - Apprendre en faisant
• Concentrez-vous sur les objectifs réels des utilisateurs - Soutenez les tâches réelles
• Prise en charge de la reconnaissance et de la récupération des erreurs - Tirer parti des erreurs
• Accès aux informations de support - Localiser rapidement les informations
Nous avons discuté de chaque principe en classe et examiné une liste de contrôle pour nous assurer de l’incorporer au contenu. Nous avons eu le plaisir de découvrir que nous avions déjà appliqué plusieurs aspects de chaque principe de la documentation JMP à l’initiative de refactoring qui a débuté avec le guide Analyse de base et représentation graphique de la version 9.
L’analyse de notre auditoire est toutefois un domaine à développer. Afin d'intégrer une approche plus centrée sur l'utilisateur, nous devons en apprendre davantage sur nos clients et effectuer des analyses d'utilisateurs et de tâches. Nous devons définir nos utilisateurs, hiérarchiser leurs besoins et décider pour qui écrire. Sans cette compréhension, le minimalisme dégénère en rendant simplement les phrases plus courtes ou en éliminant des sections de la documentation que personne ne lit.
Les minimalistes comprennent que les gens ne lisent rien qui ne semble pas permettre d’atteindre leurs objectifs immédiats. En fait, plus le texte est court et léger, plus il est probable que les gens le liront. Une approche minimaliste permet d’économiser du temps et des efforts pour produire, gérer, éditer, mettre à jour, corriger, réviser, publier et gérer le contenu. Cela permet également de résoudre les problèmes de traduction éventuels et de simplifier le message, ce qui permet de réduire les coûts de traduction.
L'agenda minimaliste met l'accent sur l'utilité et la convivialité. Notre objectif est de rédiger un contenu succinct et orienté vers l'action qui permette aux utilisateurs de comprendre rapidement ce dont ils ont besoin et de le faire avec succès. N'hésitez pas à nous faire part de vos commentaires tout en continuant d'appliquer une approche minimaliste à notre contenu.
