guide util

Guide utilisateur Quelques questions préliminaires On peut envisager trais 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ù lion 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 Swipe to page onnaitre.

La première question s or 11 se trouve-t-on ? » Ensuite, il faut se pos du produit. Cela va d Sni* to View dans quelle situation quis pour l’utilisation é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 ? ‘un document contractuel (le contrat prévoit la fourniture de ce document) ? d’un document facultatif que l’on fournit pour être agréable ? ‘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’es 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édlge. 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 de celles d’une imprimante), fichier PDF à imprimer (il faut alors prendre en compte les ressources de l’utilisateur, par exemple ne pas vider ses cartouches d’encre avec des à-plat), fichier PDF à vlsualiser, fichiers HTML, aide Windows (HLP, CHM), Si l’on fournit un document sous plusieurs formes, par exemple papier et aide en ligne, il faut envisager une solution de source unique (single sourcing).

Cela nécessite de connaître le mode de distribution et, dans le as d’un objet matériel, du format de l’emballage (packaging) : la petite taille est parfois un argument de vente (pour un téléphone portable, pour un baladeur), d’un point de vue mercatique, cela est reflété par un emballage également de petite taille, ce qui limlte la taille du document. À l’inverse, un téléviseur ou une imprimante laissent une grande latitude pour le format du document.

Enfin, il faut savoir qui va rédiger le manuel : de préférence une personne proche des utilisateurs, afin de connaitre leur culture, leurs préoccupations, mais en relati PAG » 1 roche des utilisateurs, afin de connaître leur culture, leurs préoccupations, mais en relation avec l’équipe de conception à quel stade du projet on commence à rédiger : le manuel doit être prêt au moment de la sortie du prodult, mais le produit doit être suffisamment proche de sa version finale pour que le manuel corresponde ; dans le cas d’un logiciel par exemple, la rédaction peut commencer sur la base du cahier des charges (spécifications) pour ce qui est des parties générales (présentation, mise en place des grandes parties), puis on l’affinera sur la base des versions êta (la rédaction étant une occasion de tester les fonctionnalités, donc de déterminer le produit). Les réponses à ces questions vont déterminer le format du manuel, ‘épaisseur du livre ou le nombre d’écrans d’aide.

Et cela va donc déterminer l’outil utilisé pour le créer : quel logiciel ? Un traitement de texte suffit-il ? Faut-il un logiciel de gestion de documentation ? Quel type de manuel ? On peut distinguer trois types de manuels les manuels procéduraux : on explique pas à pas comment réaliser une opération ; les manuels pédagogiques : outre la description de l’utilisation, l est destiné à transmettre des connaissances plus globales, un savoir-faire ; les manuels de référence : toutes les fonctions, parties, sont décrites par le menu. Notons que l’on peut avoir un manuel en deux parties, ou bien deux manuels, un procédural, l’autre de réference.

Dans tous les cas, on a un manuel qui ne se lit pas comme un livre, page après page, mais en accédant PAGF30F11 les cas, on a un manuel qui ne se lit pas comme un livre, page après page, mais en accédant directement à la partie utile (mise ? part pour l’introduction). Le manuel doit donc disposer : ‘une table des matières explicite et détaillée : en particulier, on intitule les sections en faisant référence au but poursuivi et non pas à la fonction utilisée ; par exemple, pour un manuel d’utilisation d’un traitement de texte, on n’appellera pas la section « Utilisation du menu Format » mais « Mise en forme du texte » ; d’un index permettant une recherche par mot-clef. Manuel procédural 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 ela commencer par identifier lesdites utilisations. 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 dolt pouvoir servir de base à ce travail.

Il ne faut pas hésiter à répéter les informations : si une personne tilise 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, o PAGFd0F11 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, on pourra utiliser les modèles. Avec LaTeX, on pourra mettre l’opération dans une commande ersonnelle (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é). Manuel pédagogique un manuel pédagogique est plutôt du type « incrémental » : c’est un manuel dans lequel on présente d’abord l’utilisation de manière générale, pour ensuite détailler certains points. Ce n’est plus exactement un manuel procédural, puisque l’on ne suit pas les opérations dans l’ordre. L’avantage d’un tel manuel est que orsque l’on présente une opération détaillée, le lecteur la replace facilement dans le contexte et connaît la finalité de l’opération. Cela permet une meilleure compréhension, une meilleure assimilation. ar exemple, pour un logiciel de traitement de données, on fait une première section présentant un traitement classique : chargement des données, traitement dans un cas simple, sauvegarde et impression du résultat. Ensuite, on va dans le détail : cas plus compliqués, paramètres ajustables, modification du format d’impression, . Dans ce type de manuel, on traitera d’exemples concrets, on pro 1 modification du format d’impression, Dans ce type de manuel, on traitera d’exemples concrets, on proposera des exercices, éventuellement appuyés sur des didacticiels (« tutoriels Par exemple, les règles vendues avec un jeu d’échecs sont certes complètes et pertinentes, mais ne permettent pas pour autant de progresser ; il faut pour cela avoir recours à un manuel pédagogique avec exemples et exercices.

On remarque que de plus en plus de logiciels dont la prise en main est relativement intuitive sont livrés sans manuel d’utilisation papier (mais toutefois avec une aide en ligne) mais n dispose de nombreux livres pédagogiques, à acheter en sus. Il suffit de regarder le rayon Mlcrosoft Word ou Adobe Photoshop d’une librairie informatique. Manuel de référence Ce type de manuel se veut exhaustif. On va là parcourir le produit de A à Z. L’organisation suit alors plus la logique du concepteur que celle de l’utilisateur : on liste les sous-ensembles un par un. Par exemple, dans le cas d’un logiciel, on va prendre les barres de boutons une par une et décrire chacun des boutons, puis les menus un par un et décrire chacune des options, puis les boîtes de dialogue, Conseils de rédaction

Structure du manuel Le manuel comporte typiquement plusieurs parties : la page de titre[21, ou pour les documents informatiques la page d’information, avec titre : c’est ce qui interpelle le lecteur, faut-il mettre simplement « mode d’emploi » ou bien « comment utiliser votre « conseils d’utilisation la référence au produit, et au(x) 6 1 utiliser votre « conseils d’utilisation », la référence au produit, et au(x) modèle(s) concerné(s) : numéro de version, date de création, la date de révision du manuel et/ou son numéro de version, d’éventuelles mentions légales, notamment relatives au droit ‘auteur et de reproduction, copyright, l’adresse de l’organisme référent pour le document, organisme auquel on peut demander un nouvel envoi si le document est défectueux, ou des remarques et suggestions, éventuellement nom de l’auteur du document , la table des matières ; en typographie française, on place la table des matières à la fin de l’ouvrage, on peut alors mettre au début un sommaire (ne reprenant que les titres des chapitres et pas les titres des sections et sous-sections) ; introduction : description rapide et globale du produit : à qui est-il destiné, ? quoi sert-il ? escription de la finalité globale du manuel : pour qui a-t-il été rédigé, dans quel esprit, comment doit-on l’utiliser (lecture continue ou bien accès direct à une section) ? xplicitation des conventions : abréviations courantes, mises en forme spécifiques (par exemple pour un logiciel, les commandes tapées sont en polices à chasse fixe, les noms des boutons sont en gras, ; présentation générale : identification des grandes parties du produit et de leurs fonctions, mise en place du vocabulaire spécifique (par exemple pour un logiciel : qu’appelle-t-on un menu contextuel, une barre de tâches) ; exte proprement dit ; éventuellement des annexes ; un index. Si des défauts, des non-confor PAGF70F11 éventuellement des annexes Si des défauts, des non-conformités, des erreurs ou bogues ont été constatés, ils doivent être signalés. Cest une preuve de responsabilité et de maturité plus que de faiblesse (tout le monde sait que le zéro défaut est un objectif, pas une réalité) ; on songera par exemple à la liste des effets secondaires dans la notice d’un médicament…

Dun point de vue organisationnel, il vaut parfois mieux sortir un produit avec des erreurs connues et signalées, que faire des odifications de dernière minute sans les tester, ou bien que faire monter le prix ou retarder la livraison : un utilisateur peut avoir un besoin immédiat d’un produit imparfait et être prêt ? fonctionner en mode « dégradé » en attendant un correctif. Cela ne doit cependant pas inclure des défauts de sécurité, et sans abus, car on risque de mécontenter l’utilisateur et d’entamer la réputation de l’organisation. Style On se méfiera du jargon technique, des anglicismes et néologismes. Est-il nécessaire pour un médecin de parler de « décubitus » pour la position allongée, pour un informaticien de ire d’une fonction qu’elle est « implémentée » pour développée/ implantée ? Ce jargon non nécessaire sème le trouble dans l’esprit du lecteur, et on se rend souvent compte qu’il n’est pas clair non plus dans celui de l’auteur.

Si un concept précis nécessite un terme précis, donc peu courant, il vaut mieux le définir qu’employer des termes obscurs à tort et à travers ; un bon réflexe consiste à essayer d’expliquer en mots plus s B1 des termes obscurs à tort et à travers ; un bon réflexe consiste ? essayer d’expliquer en mots plus simples, et en français, un mot spécifique employé. ? Ce que l’on conçoit bien s’énonce clairement, Et les mots pour le dire arrivent aisément. » Nicolas Boileau Le style utilisé doit aussi prendre en compte la culture des utilisateurs : culture professionnelle, mais aussi culture nationale, notamment lorsque l’on écrit en langue étrangère.

Penser aussi que les francophones ne sont pas tous français, mais aussi belges, suisses, québécois, sénégalais, Par exemple, les manuels de rédaction technique anglophones recommandent, lorsque l’on représente des personnes, de ne pas se contenter d’hommes blancs, mais de représenter les deux sexes et ifférentes ethnies ; ils recommandent également d’alterner l’usage du masculin et du féminin pour désigner les personnes (voir aussi Politiquement correct). La lecture d’un roman nécessite le plaisir de redécouvrir la richesse oubliée d’une langue. Au contraire un manuel doit être écrit dans une langue simple, pour être compris de tous, y compris de personnes étrangères, apprenant la langue. Mise en forme Document papier Il convient d’adopter une mise en forme sobre et homogène ; on s’intéressera particulièrement à la notion de séparation du fond et de la forme. Pour plus de détails voir : Du bon usage d’un traitement de texte. Les manuels d’utilisation ont fréquemment recours aux notes de marge.

L’avantage est que la note est située à côté du texte qu’elle commente, contrairement à une note de L’avantage est que la note est située à côté du texte qu’elle commente, contrairement à une note de bas de page ou de fin de chapitre. Cela permet, par exemple, de mettre la représentation d’un objet (comme une pièce, un bouton graphique de l’interface d’un logiciel) : le dessin ne coupe pas le texte, il ne nuit pas à la ontinuité de lecture, mais on peut le trouver facilement. Il faut pour cela définir une marge importante pour le corps du texte, de 3 à 4 cm en plus de la marge classique (par exemple, les titres et les notes de marge sont à 2 cm du bord et le corps du texte à 5 ou 6 cm).

Avec LaTeX, on utilisera pour définir les marges : dans le préambule, avec l’extension geometry, la commande rmargin=longueur} pour les marges extérieures, ou pour les marges intérieures[3] la commande en chargeant éventuellement les extensions mparhack, manfnt si le placement se fait mal. Avec un traitement de texte classique, on peut utiliser pour les notes de marge un tableau à deux colonnes sans filet (trait) : la colonne de gauche est dans la marge et contient les notes, la colonne de droite contient le texte. Les notes de marge sont fréquemment utilisées pour mettre des symboles attirant l’attention du lecteur sur le point détaillé dans le texte ou indiquant le statut du texte (par exemple : indication de sécurité, opération délicate). Il faut adopter une présentation aérée, avec des grandes marges, et changer de page entre chaque sujet, afin d’ 11