Documentation & rédaction technique

Infos, tendances, formation

Discuter DITA sur les blogs…Se taire est une option !

Discuter DITA sur les blogs…Se taire est une option !

  Encore une bonne occasion perdue de se taire !… Lors d’une discussion intéressante sur le thème : DITA, comment démarrer, plusieurs intervenants ont suggéré des manuels, articles, etc. à mettre sous le coude et à potasser à bon escient. Julio Vasquez, qui est plutot du genre prolifique (et je te twitte à toute heureEn savoir plus surDiscuter DITA sur les blogs…Se taire est une option ![…]

Moisson de copies d’écran ?

Moisson de copies d’écran ?

Trop souvent, les manuels sont envahis de copies d’écran. On se demande, mais pourquoi faire ? … Ne cherchez pas : pour faire joli ! Éventuellement, pour masquer un vide. Le rédacteur ne savait pas trop quoi indiquer, alors il a rajouté une copie d’écran. Cela rompt la monotonie du texte…

Mais sommes-nous mandatés pour agrémenter la lecture de nos utilisateurs ?

Mode d'emploi: Comment construire une cathédrale

Ne sommes-nous pas plutôt sur la brêche pour AIDER l’utilisateur à accomplir une tâche ?

Alors, quand et comment insérer une copie d’écran ?

Voici quelques extraits d’une discussion sur l’utilisation des copies d’écran à la fois dans un document papier et dans une aide en ligne :

Dans un manuel papier  « The most important thing to remember is that a screen capture will never have larger resolution that 72 dpi. This means that it will often look really bad if you try to make it larger or smaller. Therefore, don’t change the size of the images in online formats.
If you must change size, the only way to « survive » is to use PhotoShop. It still won’t be perfect, but at least it’s a bit better. »

Lire la suite de à propos deMoisson de copies d’écran ?

Documentation technique : les guides  indispensables

Documentation technique : les guides indispensables

Si, pour aider vos équipes de documentation, vous souhaitez leur fournir une solide bibliographie, voici de quoi démarrer :

(1) GNOME Documentation Style Guide V1.6
Il s’agit du guide rédactionnel de l’équipe UNIX, disponible en ligne. A consulter sans modération !

(2) EU Interinstitutional Style Guide
Parfait pour ceux qui travaillent peu ou prou sur des sujets liés aux Institutions Européennes.

(3) Read me First!
A Style Guide for the Computer Industry
2nd Edition – ISBN: 0131428993
SUN Microsystems

Guide rédactionnel de dimension raisonnable

et facilement consultable.

 

 

 

 

Lire la suite de à propos deDocumentation technique : les guides indispensables

Interview exclusive de JoAnn Hackos

Interview exclusive de JoAnn Hackos

A L’issue de la conférence CMS/DITA North America, JoAnn Hackos, organisatrice de nombreuses conférences -dont DITA Europe et DITA North America- a bien voulu nous accorder, en exclusivité, une interview. Elle tire le bilan de cette rencontre à Baltimore et conclut sur l’importance, pour les acteurs de la rédaction technique, de participer à ces rencontresEn savoir plus surInterview exclusive de JoAnn Hackos[…]

Intelligibilité ?

Intelligibilité ?

Intelligibilité, c’est le mot savant pour parler « compréhension d’un texte » dans notre métier. On peut rapprocher cela de _l’utilisabilité_. Voici quelques liens sur l’utilisabilité, vue par nos collègues anglophones : Usability resources – Wonderful, structured, useful! http://www.paulhibbitts.com/usability-ucd-ux-recommended-links-and-tools.html En francais, le spécialiste de l’ergonomie de la documentation, est Monsieur Franck Ganier, Maître de conférences à l’UniversitéEn savoir plus surIntelligibilité ?[…]

Cliquer en couleur ?

Cliquer en couleur ?

La route des couleurs

Dans les sites Web, les boutons qui demandent au surfeur-lecteur de réagir :    « Confirmer » , « Continuer« , « Envoyer » ,  « Commander » , etc. … est-ce que cela vaut le coup de s’y arrêter ?

Les boutons et la psychologie de la couleur

C’est ce que démontre Paul Olyslager dans son article
« Call to Action buttons and the psychology of color« 

De la couleur en toute  chose…

Au-delà des banalités « Bleu est une couleur froide, rouge est une couleur chaude », l’auteur aborde l’aspect culturel de la couleur. Ah bon !… Il était temps de le découvrir.

Lire la suite de à propos deCliquer en couleur ?