Veuillez cliquer ici pour aider David McMurrey payer pour l'hébergement web :
Faites un don de tout petit montant que vous pouvez !
La rédaction technique en ligne restera gratuite.
Lorsque vous rédigez des instructions, des procédures et des informations de "guide" ou de guide utilisateur, vous devez généralement adopter une approche par tâches. Cela signifie fournir des étapes et des explications pour toutes les analyses de tâches principales que les utilisateurs pourraient avoir besoin d'effectuer.
Bien sûr, certaines instructions impliquent une seule tâche—par exemple, changer l'huile d'une voiture. Mais nous nous intéressons ici à des procédures plus complexes. Bien que ce chapitre utilise un logiciel informatique comme exemple, ces techniques peuvent s'appliquer à toute procédure multi-tâches—par exemple, utiliser un four à micro-ondes.
Identification des tâches
Pour écrire de manière orientée vers les tâches, vous devez d'abord effectuer une analyse des tâches. Cela signifie étudier comment les utilisateurs utilisent le produit ou accomplissent la tâche, les interviewer et les observer. Cela peut également signifier interviewer des personnes du marketing et du développement de produits. Si vous pouvez obtenir les types de questions que reçoivent les agents du support technique, cela aide aussi.
Mais parfois, vous ne pouvez pas être en mesure de faire une analyse approfondie de la tâche. En général, les développeurs de produits ne pensent pas à la documentation avant assez tard. Dans ces circonstances, il est souvent difficile d'amener les personnes du marketing, du développement, de l'ingénierie et de la programmation à passer suffisamment de temps avec vous pour expliquer le produit en détail. Et donc, vous finissez par faire un certain nombre de suppositions éclairées. Le développeur est plus susceptible de revoir votre brouillon et de vous faire savoir si vos suppositions sont correctes.
Pour développer votre propre analyse de tâches, vous pouvez étudier l'interface utilisateur (boutons, menus, options, etc.) du produit. Cela vaut pour le matériel et le logiciel. Considérez l'interface d'un outil d'édition d'icônes montrée ci-dessous. À partir de ce simple extrait de l'interface, vous pouvez identifier plusieurs tâches évidentes : Nouveau, Ouvrir, Enregistrer sous, Quitter :
Interface pour l'édition d'icône AZ |
Maintenant, regardez les options du menu pour les prochaines parties du menu. Vous pouvez voir que lorsque les gens utilisent cet éditeur d'icônes, ils seront également très probablement en train d'effectuer ces analyses de tâches :
|
Mais maintenant, regardez l'interface sans les options de menu qui pendent. Quelle analyse_des_tâches supplémentaire pouvez-vous voir ? Comme avec beaucoup d'interfaces graphiques, certains des icônes dupliquent les options du menu. Par exemple, l'icône de liste à puces vous permet de sélectionner une ligne fine, moyenne ou épaisse de la même manière qu'en cliquant sur Options le fait. Cependant, il y a de nouveaux outils ici, non disponibles ailleurs dans l'interface :
|
Il y a beaucoup de choses que vous ne savez toujours pas sur ce logiciel, mais vous avez déjà fait beaucoup de conjectures pour définir la principale analyse des tâches. Vous voudriez regrouper et consolider les éléments de manière beaucoup plus serrée que ci-dessus, peut-être comme ceci :
- Créer, modifier, renommer et enregistrer des icônes
- Sélectionner la couleur de premier plan et la couleur de fond
- Dessiner des lignes, des rectangles et des ovales
- Couper, coller et copier des objets
- Déplacer, retourner et faire pivoter des objets
Vous pouvez voir que dans cette liste de tâches incomplète, il n'y a aucune trace d'une analyse des tâches telles que remplir un objet de couleur, capturer des images, vider l'espace de travail, annuler une erreur ou restaurer. Mais au fur et à mesure que vous travaillez, ces détails commenceront à trouver leur place dans votre schéma. Maintenant, éloignez-vous des détails de l'interface et mettez-vous à la place d'un utilisateur de logiciel d'icônes. Quelles questions cette personne est-elle susceptible de poser ? Comment puis-je changer la couleur de l'arrière-plan ? Nous avons cela sous contrôle. Comment puis-je changer l'épaisseur des lignes que je dessine ? Cela aussi, nous l'avons couvert. Comment puis-je rendre l'arrière-plan transparent ? Hmmm... cela posera un problème pour la section couleur, mais cela nécessitera un peu de recherche.
Différentes Approches de la Documentation
Lorsque vous écrivez pour les utilisateurs, vous avez le choix entre deux approches, fonction orientation et orientation vers les tâches, ce dernier étant de loin le meilleur choix.
Écriture avec une orientation fonctionnelle. Il devrait être évident comment procéder après une analyse des tâches, mais apparemment ce n'est pas le cas. Les publications informatiques—si ce n'est les publications techniques en général—semble souvent s'éloigner d'un style d'écriture orienté sur les tâches. Mais non ! Ça ne fonctionne tout simplement pas !
Une autre raison pour laquelle certaines instructions des guides utilisateur ne sont pas orientées vers les tâches peut être attribuée aux spécifications du produit. Les spécifications du produit, qui sont écrites par et pour les programmeurs, les ingénieurs, les développeurs, sont rédigées en termes de fonction requise :
| Bouton de menu Fichier | Permet à l'utilisateur de créer un nouveau fichier, d'ouvrir un fichier existant, de renommer un fichier, etc. |
| Icône de recadrage | Permet à l'utilisateur de couper le segment sélectionné de l'image. |
Vous pourriez appeler cette approche orienté vers les fonctions écriture parce qu'elle explique systématiquement chaque fonction, caractéristique ou élément d'interface d'un produit. Malheureusement, cette approche apparaît dans les manuels d'utilisation destinés aux lecteurs non techniques—peut-être parce que les auteurs manquent d'expérience, ne sont pas formés ou sont peu techniques ; ou alors les auteurs ont été appelés trop tard pour faire autre chose que peaufiner les spécifications des développeurs.
L'approche orientée fonction fonctionne presque parfois. Mais "presque" et "parfois" ne sont pas suffisants. Cela fonctionne presque parce que les noms des éléments d'interface et des fonctions correspondent parfois à l'analyse de tâche qu'ils soutiennent. Par exemple, le Ouvert l'option de menu est assez intuitive : ouvrir un fichier existant. D'autres ne le sont pas. Par exemple, que pensez-vous qu'il soit restauré par le Restaurer bouton dans l'interface AZ Icon Edit ? De plus, certains éléments de l'interface n'accomplissent pas des tâches tout seuls. Dans Photoshop, par exemple, vous ne pouvez pas rogner du texte en appuyant sur le Culture option de menu. Vous devez d'abord cliquer sur le bouton de sélection de texte, puis dessiner un rectangle de sélection autour de la partie de l'image que vous souhaitez conserver, puis appuyer sur le Récolte bouton.
Écrire avec une orientation vers les tâches.Au lieu de l'approche axée sur les fonctions, utilisez l'approche axée sur les tâches. Identifiez les tâches que les utilisateurs devront effectuer avec le produit, puis structurez votre document en conséquence. Rédigez vos titres et sous-titres. orienté vers les tâches dans leur formulation. La formulation orientée vers la tâche signifie formuler comme "Comment ajuster le volume", "Ajuster le volume" ou "Ajustez le volume." Cela ne signifie pas formuler comme "Volume" ou "Ajustement du volume." Voici quelques exemples supplémentaires :
| Formulation du problème | Formulation orientée vers les tâches |
| Capture | Capturer des images |
| Bouton d'écran | Sélectionner des objets d'arrière-plan ou de premier plan |
| Rectangles | Dessiner des rectangles |
| Icône ovale | Dessiner des ovales et des cercles |
Lorsque vous avez défini l'analyse des tâches utilisateur, organisé ces tâches en groupes logiques et défini des titres orientés vers les tâches, vous êtes prêt à écrire ! Voici un extrait :
|
Dessin de rectangles et d'ovales Vous pouvez utiliser l'éditeur d'icônes pour dessiner des carrés, des rectangles, des ovales et des cercles. Dessinez un rectangle. Pour dessiner un rectangle :
|
Dans cet extrait, vous pouvez voir qu'une approche globale axée sur les tâches est adoptée et que des formulations orientées vers les tâches sont utilisées pour les titres.Dessin). Notez également que des listes numérotées sont utilisées pour guider les lecteurs étape par étape à travers les actions impliquées dans la tâche.
Informations connexes
Écriture basée sur des tâches. DFT
J'apprécierais vos réflexions, réactions, critiques concernant ce chapitre : votre réponse.
