Catégorie : documentation

The illusion of « minimalist writing »…

No, there is nothing like « minimalism writing » in technical documentation … Neither John M. Carrol nor Hans van der Meij developed anything of that kind. Their research demonstrated the feasability of the MINIMALIST APPROACH (call it methodology or design philosophy) that is now an integral part of ISO 82079 (2019) – art. 5.3.3 Writing for… Lire la suite …

Are you a competent technical communicator?

The creation of information for use shall be assigned to competent persons (*) (*) ISO 82079 -article 10.1 Are you a competent person? Sure you are… because you love writing. That’s why you decided to move to Technical Writing. If you have been excellent at English composition, you might be competent when embracing the profession… Lire la suite …

Des avertissements dans mon ISO ? …

…. Dites, si on parlait messages de sécurité ? La norme IEC/ISO 82079 vient d’être mise à jour et y consacre la section 7.1 (« Safety-related information ») Comment classer les catégories d’avertissements ? Trois types d’information de sécurité : (a) safety signs and product safety labels (b) safety notes (c) warning messages Que dire du placement… Lire la suite …

Les « Happy Few » de la Stratégie de contenus

Mindtouch, aux USA, a établi la liste des  200 « Happy fews« , c’est-à-dire les 200 Experts en stratégie de contenu, les « 200 OUTSTANDING CONTENT EXPERIENCE STRATEGISTS« . Comment cette liste a-t-elle été établie ? Les responsables ont collecté une « wide range of metrics including internet presence, influence, community engagement, and participation (including conference appearances) ». Beaucoup de têtes… Lire la suite …

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 …

Hiring a technical writer, … not a typist !

Don’t hire a technical writer to fill in a typist’s position Dear recruitment agency , do me a favour (and make your agency save money): do a proper job. Don’t be a fool: make the difference between a typist and a technical writer A typist is « A person who types especially as a job ». You… Lire la suite …

Sur les traces de l’utilisateur-type

Pourquoi organiser la chasse à l’utilisateur ?   L’utilisateur de nos produits est le lecteur de nos documentations techniques. Pour lui fournir une documentation adaptée et efficace, il faut comprendre ses besoins et donc aller à sa rencontre.   Comment intégrer l’utilisateur dans notre activité de rédaction ? Pour augmenter l’efficacité de notre documentation, nous… Lire la suite …

Universities working in silos?

… No! Sharing knowledge cross-country, yes! Time when universities were performing and disseminating research in restricted areas is OVER! Adhering to University Rennes 2 ‘s initiative, a good bunch of universities and « Hochschulen » join forces to disseminate technical documentation research to Master students. On Feb 4, 2016 European universities are video-conferencing (live) from Rennes to… Lire la suite …

Minimalist documentation is not a suitcase!

Minimalist documentation is not a suitcase!

Designing minimalist documentation is increasingly in demand. In particular, due to documentation experts migrating their content to DITA.  Not surprising, aliens now decide to board the train of minimalism  … and miss the step because minimalism is not a suitcase! What is minimalism? « Minimalism consist in identifying the smallest amount of instruction that allows for… Lire la suite …

ERIKSON
GSX
COHERIS
SCHLUM
EFFICIENT
OPTIS
INTERSEC
NMJ
TALEND
LYRA
HILL
HORIBA
ERIKSON
GSX
COHERIS
SCHLUM
EFFICIENT
OPTIS
INTERSEC
NMJ
TALEND
LYRA
HILL
HORIBA

logo-bleu

Établissement de formation à la documentation technique

Formatrice : Marie-Louise Flacke

Graduate of the American
University of Paris
Tel. 06 03 20 50 10

… mais que signifie Awel-A-Ben ?

Contact

BLOG

blog-icon

 

PRESS

press-icon