Séminaire intensif de 3 jours sur la documentation technique
Séminaire intensif itl sur la documentation technique: 35 ans de savoir-faire concentrés pour vous.
Notre devise: «Des connaissances issues de la pratique, pour la pratique – mais associées à la bonne théorie».
- Toujours à la pointe:
Nous vous tenons au courant des dernières tendances et des grands thèmes intemporels de la documentation technique. - Les participants au centre:
Venez avec vos exemples pratiques de documentation. L’animateur sera heureux de s’y référer pendant les séances. (Courage. Pour réussir, il faut oser!) - Des supports de formation pratiques:
Nous vous remettons les documents pédagogiques et les exercices sous la forme d’une collection de fichiers PDF que vous pourrez facilement compléter avec vos notes tout au long du séminaire. L’ensemble constituera un précieux recueil d’informations qui vous servira de référence au quotidien.
L’accord parfait: clarté, convivialité, orientation processus.
Des modèles fondés sur la théorie et la pratique
On parle toujours des «bonnes pratiques». Mais pourquoi n’y aurait-il pas de «bonne théorie»?
Sans bases théoriques, l’apprentissage par la pratique n’est que parcellaire.
Clarté – Le concept
De Hambourg à Munich, en passant par Vienne et Karlsruhe – nous vous présentons en exclusivité le modèle de Munich, une approche globale pour une documentation technique claire!
Et tout deviendra limpide, car comme le décrit Mark Twain: «La différence entre le mot juste et le mot presque juste est la même qu’entre l’éclair et la luciole.»
Clarté – Choix des mots et terminologie
Pourquoi vaut-il mieux appeler un chat un chat? Pourquoi la terminologie est-elle un aspect central, et pas juste une fioriture?
Et pourquoi ne peut-on plus se contenter d’un dictionnaire général?
Clarté – La construction de la phrase
Pourquoi les phrases simples sont-elles idéales pour une bonne documentation technique?
Pourquoi ce que vous avez appris à l’école peut-il vous induire en erreur?
Clarté – Les éléments informatifs et le séquençage
Le meilleur de l’Information Mapping®, du Funktionsdesign®, de DITA® et des principes du parallélisme.
Les avertissements
L’indispensable déconstruction des mythes autour de l’ANSI, l’ISO et SAFE.
En exclusivité: toutes les mentions d’avertissement en 40 langues, toutes les phrases clés des normes et directives courantes.
Clarté – Les modèles mentaux
Pourquoi ne nous comprenons-nous pas? Et quand nous comprenons-nous? La connaissance des modèles mentaux est la clé de la clarté.
Clarté – La visualisation
Les modèles mentaux sont le point de départ d’une visualisation efficace.
L’analogie de la phrase pour une grammaire visuelle claire.
Les nouvelles possibilités des images animées (vidéo, 3D, GIF animé).
Orientation processus – Le «topic design»
Du document au sujet.
«Every page is page one». L’utilisateur ne veut pas lire des pages, mais obtenir des réponses à ses questions. La solution: remplacer les chapitres et sections par des unités d’information thématiques.
Orientation processus – Structuration, modularisation, classification
La différence entre modules et sujets. De la structure d’information classique à la classification PI®. Le meilleur de l’Information Mapping®, du Funktionsdesign® et de DITA®.
L’UX design pour la documentation technique
Comment utilise-t-on une documentation technique? Certains aspects qui peuvent sembler évidents pour un support papier ne s’appliquent plus au format électronique. La documentation électronique est soumise aux mêmes critères d’ergonomie que tout autre logiciel développé.
L’UX design (User Experience Design) est un concept global relativement nouveau. itl a opérationnalisé des normes d’ergonomie classiques telles que l’ISO 9241-110, 11, 112, 210 pour la documentation électronique sous l’angle de l’UX design et développé un nouveau concept-cadre: l’UxD itl. Notre approche repose sur trois éléments clés:
- PentaQuest: une mise en œuvre efficace de la modélisation des personas pour la documentation technique
- Contexte et catégories d’utilisation: la base de toute modélisation de l’information
- Aspects médiatiques: les paramètres de base d’une information utilisateur multimédia
Lois, directives et normes
Ce séminaire vous fraie un chemin à travers la jungle des directives, lois et normes qui régissent la documentation technique. En passant, il rétablit la vérité sur certaines croyances, par exemple l’obligation ressentie d’utiliser certains supports ou de proposer la documentation sur papier.