writing for the user Archives

Catégorie : writing for the user

Migrating to DITA : skip & clean…but keep the Shortdescription!

DITA Migration is like house removal: you’d better get rid of the unecessary stuff and clean your files BEFORE you move on. Don’t hesitate to skip and clean! Following this rule, a 2014 DITA Europe Conference participant who wanted to reduce the volume of her documentation decided to skip all Short Descriptions… Not only was… Lire la suite …

L’utilisateur de documentation est un gros balourd !

Et c’est là le gros problème du rédacteur. Surtout celui qui veut faire un travail de qualité ! Comment expliquer l’utilisation du produit si l’utilisateur est handicapé du bulbe ? Prenons l’exemple de ce guide utilisateur (bilingue). Il est destiné aux responsables d’entreprises voulant enregistrer un « détachement de travailleurs en France » donc, s’adressant à… Lire la suite …

IoT messages for Sergio and David

In his article Smart factories require smart documentation, Alexander Hoffmann states: « Connected Things will dominate the Internet, the cities and our lives…The Internet of Things is growing exponentially… 26 billion Things will be connected by 2020… » Which impact on our technical writer’s job? « Thus, there is a growing demand for digital manuals that are displayed… Lire la suite …

What’s in a minimalism workshop?

What are you going to learn in a minimalist workshop? No, you won’t cut words and you’ll go on writing complete, grammatically correct sentences. You’ll learn how to provide the necessary information to your users… and, above all, you’ll learn how to respect your users. Too often, information developers forget the essential: their user… Lire la suite …