Approche Générale

Conception documentaire

Une organisation de l’information orientée « tâche »

Notre approche de la documentation destinée au guidage d’un utilisateur (Manuels et Aides diverses) est fondé sur l’analyse du travail : le principe d’organisation du texte n’est donc pas le chapitre, la section, ou le paragraphe, mais une arborescence de tâches partitionnées en sous-tâches. La structure du manuel reflète ainsi celle du travail, puisque l’activité est un ensemble coordonné de tâches.  Un document conçu sur ce socle est, de ce fait, en adéquation écologique avec les objectifs et la situation de son lecteur, c’est à dire, naturellement ergonomique.

Notre méthode d’analyse de l’activité est TIM (de là le nom de notre entreprise). TIM est l’acronyme de Task-oriented Information Modelling. Il s’agit d’un langage permettant de décrire des situations de travail au moyen d’une arborescence de tâches et de représenter leur structure de façon harmonisée.

L’objectif de cette description est de fournir le contenu de documents qui accompagnent des produits (manuels-utilisateur, aides en ligne, manuels de maintenance, etc.) mais également de définir les processus productifs d’une entreprise (exprimés dans le manuel de procédures) ou les spécifications fonctionnelles d’un système et l’architecture de son interface.

TIM a été conçu comme un outil pour modéliser l’activité dans le but de générer des manuels.

Des documents aux normes en vigueur.

La documentation est un domaine sensible. De nombreuses normes déterminent les façons de :

  • concevoir une arborescence documentaire,
  • rédiger une documentation pour un utilisateur final,
  • organiser les documents entre-eux.

Nous travaillons, en fonction des projets, avec les normes adéquates : avec les normse ISO pour réaliser des documents qualité, mais aussi avec des Directives (Directive Machine) et des préconisations NF ISO, notamment :

  • NF EN ISO 61355,
  • NF EN ISO 9241 (notamment 11,12,13,15,16),
  • NF EN ISO 11442 (notamment 1,2,3,4,5),
  • NF EN ISO 81714-1,
  • NF ISO 1087-1,
  • NF ISO 15226,
  • NF X 60 200, 210, 212,
  • NF X 010, 012, 201, 250…

La récente norme sur la documentation-utilisateur dans le domaine du logiciel (ISO 26514, 15 juin 2008) accorde une importance particulière à l’organisation du contenu du point de vue des tâches.

La décomposition de l’activité en étapes est abordée en 11.7.2, en particulier, la segmentation de tâches en sous-tâches lorsque le document est à caractère pédagogique (11.7.4).

Nous avons conçu un outil de documentation (TimBox) qui permet de produire facilement le contenu de manuels et aides conforme à ces préconisations.

Contactez-nous !