guide util
Quelques questions préliminaires
On peut envisager trois situations : il s'agit d'un produit simple d'utilisation ; il s'agit d'un produit complexe, mais on veut restreindre les explications aux cas les plus simples, les cas complexes étant à la charge de spécialistes, (c'est par exemple le cas d'un manuel d'entretien d'une automobile où l'on explique comment vérifier le niveau d'huile, changer une roue ou les ampoules, mais les réparations plus complexes sont à la charge d'un garagiste ou d'un amateur éclairé) ; il s'agit d'un produit complexe dont l'utilisateur final doit tout connaître.
La première question à se poser est donc : « dans quelle situation se trouve-t-on ? »
Ensuite, il faut se poser la question des prérequis pour l'utilisation du produit. Cela va déterminer le niveau de détail des explications et le vocabulaire employé : faut-il en particulier définir les termes spécifiques, ou bien ceux-ci sont-ils considérés comme acquis ?
Par ailleurs, il faut connaître le statut légal du document, s'agit-il : d'un document obligatoire d'après la législation ou la réglementation ? d'un document contractuel (le contrat prévoit la fourniture de ce document) ? d'un document facultatif que l'on fournit pour être agréable à l'utilisateur (pour des raisons commerciales ou bien pour l'aider à utiliser un produit libre et gratuit) ou que l'on vend à part du produit (par exemple un manuel d'utilisation d'un logiciel qui n'est pas vendu avec celui-ci).
En cas d'obligation légale, réglementaire ou contractuelle, il faut connaître les termes de l'obligation pour s'y conformer. Il se pose également le problème de la langue dans laquelle on rédige. Dans le cadre d'une démarche qualité, il faut recueillir auprès des utilisateurs leurs attentes et avis sur la documentation, celle-ci suit un cycle d'amélioration continu.
Le type de document produit est également important : document papier imprimé (les contraintes d'un imprimeur sont différentes