« La documentation/Rédaction technique/Rédaction d'un manuel d'utilisation » : différence entre les versions
Contenu supprimé Contenu ajouté
m diverses retouches |
m Robot : Corrige les liens pointants sur des redirections |
||
Ligne 67 :
Ce type de manuel doit permettre à une personne de prendre en main le produit rapidement. Il est bien adapté pour une personne non qualifiée (opérateur ne maîtrisant pas la théorie sous-jacente à l'utilisation du produit), un débutant ou un travailleur intérimaire, un stagiaire, en cas de départ de la personne utilisant habituellement le produit. Les entreprises écrivent fréquemment des procédures, le manuel doit pouvoir servir de base à ce travail.
Il ne faut pas hésiter à répéter les informations : si une personne utilise le produit en ayant le manuel à la main, il est vite ennuyeux de devoir tourner les pages pour trouver une autre information, puis de revenir. Si une opération est présente dans plusieurs procédures, on ne fera pas de référence croisée (de type « voir la section 1.7 p. 28 »), l'opération sera donc écrite intégralement à chaque fois. Si le manuel est rédigé avec un logiciel de type [[MediaWiki pour débutants|MediaWiki]], on pourra utiliser les [[w:Aide:Modèle|modèles]]. Avec LaTeX, on pourra mettre l'opération dans une [[Programmation LaTeX/Mise en forme du texte#Commandes personnelles|commande personnelle]] (voire dans un fichier spécifique).
Le manuel doit être abondamment illustré par des dessins ou des photographies clairs (pensez que certaines entreprises font des procédures sous forme de bande dessinée pour le personnel illettré).
| |||