Manuels

Un manuel, tel que nous le définissons ici, est une combinaison de ce qui suit :

• concept information
• instruction information
• informations de référence

tout axé sur un sujet spécifique répondant aux besoins d'un public particulier. Si vous suivez un cours d'écriture technique utilisant ce livre, votre projet de manuel doit inclure d'une manière ou d'une autre chacun de ces trois éléments. De plus, ces éléments devraient être une "ajustement" naturel et logique pour votre projet de manuel.

Assurez-vous de consulter le exemples.

Infographie générée par NotebookLM de ce chapitre

Notions de base du manuel

Concepts. L'information conceptuelle explique comment les choses fonctionnent, comment les choses sont assemblées. Pour des instructions plus complexes, vous devez connaître certains concepts, théories, arrière-plans, principes pour exécuter les instructions. Prenons l'exemple de la fonction logicielle qui vous permet de modifier ou de créer votre propre couleur. Utiliser quelque chose comme Photoshop, Illustrator, CorelDraw ou Paint Shop Pro pour cela—les véritables boutons et curseurs— est facile. Mais comprendre comment la teinte, l'intensité, la luminosité, la saturation, la densité, le contraste, RGB—c'est difficile. Vous devez connaître la théorie des couleurs informatiques pour créer la couleur dont vous avez besoin.

Considérez un autre exemple : des commandes simples de système de fichiers Linux —ls, cd, cp, mv, pwd. Pour utiliser ces commandes, vous devez comprendre ce que sont les fichiers et les répertoires, et probablement ce qu'est un système d'exploitation ainsi que les jokers. Vous ne pouvez vraiment pas comprendre comment utiliser ces commandes —suivre des instructions en les utilisant —à moins que vous ne compreniez ces concepts de base.

Instructions. Si vous comprenez les concepts fondamentaux, alors vous pouvez suivre intelligemment les procédures étape par étape. Les instructions sont ces listes numérotées familières qui vous guident soigneusement à travers une procédure. Les instructions sont partout, sur les emballages de produits, dans les guides d'utilisation qui accompagnent les appareils et les ordinateurs.

Référence. La dernière catégorie d'informations concerne les informations de recherche, ou les informations de référence rapide. Si vous avez suivi l'exemple du système de fichiers ci-dessus, vous avez d'abord dû étudier et apprendre les concepts de fichiers, de répertoires, et des jokers. Ensuite, vous pouviez suivre et comprendre les instructions sur le changement de répertoires, la copie, la suppression ou le déplacement de fichiers. Après un certain temps, cependant, vous n'avez plus besoin des instructions, mais de temps en temps, vous avez des besoins spéciaux non couverts dans la section d'instructions ou vous ne pouvez pas vous souvenir de certaines procédures qui ont été abordées dans la section d'instructions. C'est le moment où vous avez besoin d'informations de base : il vous suffit de vous rendre dans cette section et de les consulter rapidement.

Et donc, après un certain temps, vous n'avez plus besoin ni de la section des concepts ni de la section des instructions : vous vous êtes tellement habitué à ces procédures que vous les connaissez par cœur. Mais de temps en temps, vous oubliez un petit détail ou vous avez une tâche spéciale que vous n'avez jamais faite auparavant — c'est alors que vous allez à la section de référence. Vous pourriez probablement déchirer les sections des concepts et des instructions et les jeter. Tout ce dont vous aurez jamais besoin, c'est de la section de référence.

Format et style du manuel

Dans un cours de rédaction technique utilisant ce livre, il se peut que l'on vous demande d'utiliser des directives spécifiques pour l'utilisation des titres, des listes, des avis, des graphiques, des tableaux, de la documentation et des introductions :

Prototype de manuel. À partir du lien ci-dessous, vous pouvez obtenir une version fictive du manuel. Il comprend toutes les pages requises dans un bon format. Inclus dans ce document Word, vous trouverez des styles de paragraphe et de caractère qui faciliteront votre travail et ajouteront des compétences professionnelles à votre répertoire.

Prototype de manuel

Prototype de contenu. Le prototype de la table des matières est particulièrement utile : il vous donne les styles Word pour produire une table des matières au look professionnel. Il est difficile d'obtenir les alignements à gauche et à droite ainsi que les points de guide correctement :

Prototype de table des matières

Exemples de manuel

Voici quelques liens vers des exemples de manuels. Soyez conscient qu'il y a des problèmes dans les exemples, dont la plupart ont été commentés par mes soins. Certains d'entre eux sont à la limite des manuels. Ce qui fait un manuel pour moi, c'est la présence de discussions conceptuelles, d'instructions et d'informations de référence.

Assurez-vous de consulter le exemples.

Invites IA pour manuels

Les listes de contrôle, qui restent généralement non lues, peuvent être utilisées comme source pour des invites d'IA avec quelques modifications. Copiez ce qui suit, collez-le dans un système d'IA comme Gemini de Google, et voyez ce que vous avez peut-être manqué.

Remarque : Toutes les références au contenu, au format et au style des techdocs ou de ses composants peuvent être trouvées dans le manuel de rédaction technique en ligne.

arrivée bientôt !

J'apprécierais vos réflexions, réactions, critiques concernant ce chapitre : votre réponse—David McMurrey.