« La documentation/Rédaction technique/Rédaction d'un manuel d'utilisation » : différence entre les versions
Contenu supprimé Contenu ajouté
m Révocation des modifications de 92.103.119.121 (discussion) vers la dernière version de 195.5.241.194 |
|||
Ligne 64 :
Un manuel de type procédural est un manuel pas à pas. Dans le cas d'un produit complexe, il ne va pas expliquer la totalité du produit, mais simplement les principales utilisations. Il faut pour cela commencer par identifier lesdites utilisations.
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).
|