Intervention de Boris Kadir

Critères techniques et marketing permettant de déterminer le niveau de difficulté d'une future documentation

La conception et la réalisation d'une documentation peut être tributaire d'un certain nombre de difficultés :

• domaine peu ou pas du tout connu du rédacteur
• difficulté d'appréhender de façon suffisante ce domaine
• terminologie spécifique au domaine et au produit (et variantes de cette terminologie)
• éventuellement, nombre, complexité et contenu informationnel des expressions mathématiques présentes dans la documentation existante (et aussi, nombre de versions différentes de ces expressions existant dans la littérature)
• nombre de fonctions
• nombre de paramètres et interdépendance entre eux
• complexité de l'arborescence constituée par les menus, sous-menus… et éventuellement, présence de "torsions" de cette arborescence (c'est-à-dire certaines branches de l'arborescence qui devraient être placées ailleurs)
• pour un logiciel, nombre et complexité des fenêtres (nombre de champs ou de boutons, actions cachées…)
• compréhension non immédiate ou non intuitive des fonctions, des paramètres ou des choix
• manque d'homogénéité dans la terminologie utilisée ou dans les modes de fonctionnement…
• faiblesses d'ergonomie plus ou moins prononcées
• distance entre le niveau de connaissances des utilisateurs de la technique spécifique au produit et le niveau d'expertise du fabricant
• nombre de manipulations nécessaires à la compréhension effective des fonctions et des paramètres
• volume et/ou difficulté de lecture de la documentation existante
• ou, au contraire, faible volume de documentation par rapport au nombre de fonctions et de paramètres du produit
• volume d'informations utiles mais non écrites découvertes au cours du processus documentaire
• niveau de fiabilité de la version en cours de développement du produit à documenter
• faible importance accordée à la documentation
• faible disponibilité des différents intervenants
• relations de pouvoir au sein de l'entreprise, en particulier entre le Bureau d'Etudes et la Direction Marketing
• etc

Ces difficultés peuvent sensiblement alourdir la tâche du rédacteur en charge de la documentation d'un produit ou d'une gamme de produits, voire rendre le travail quasiment impossible.

Il est donc important de pouvoir déceler suffisamment tôt, de préférence avant de s'engager, les pièges auxquels peut se trouver confronté le rédacteur, quel que soit son statut vis-à-vis de l'entreprise commercialisant le produit (salarié ou prestataire).

Le débat portera donc sur les signes permettant de mieux cerner les difficultés futures d'une documentation afin de pouvoir prendre les mesures ad hoc (voire de renoncer au travail, ce qui parfois peut s'avérer être un choix très judicieux).

A propos de Boris Kadir

Expérience professionnelle et compétences spécifiques relatives à votre contribution. Ces informations seront publiées dans le programme de COMTEC 2003.

Conception et réalisation de documentations d'utilisation et de documentations didactiques, principalement dans les domaines suivants : instrumentation industrielle, automatique, régulation, informatique industrielle, physique appliquée.