[Ai] Rédaction des sections, étapes et notes

Votre style doit transparaître dans la rédaction de votre tutoriel. Évitez tout discours « promotionnel » ou détail inutile.

Consignes de rédaction des sections, étapes et notes

Tous les tutoriels créés dans Tutorial Builder pour Illustrator sont composés de sections, d’étapes et de notes. Il vous incombe de déterminer comment organiser le contenu du tutoriel, en le répartissant dans différentes sections.

Chaque section contient une série d’étapes et parfois des notes. En principe, des étapes successives ne doivent pas être rattachées à deux sections différentes (sauf si la première section a besoin d’une suite). Toutes les étapes sont numérotées. En revanche, les notes ne le sont pas. Elles fournissent simplement un complément d’information au sujet d’une étape.

Certaines informations doivent être saisies manuellement plutôt qu’enregistrées. Pour ajouter manuellement une étape numérotée, utilisez systématiquement la commande Position > Zone de travail.

Adoptez un style clair et concis pour la rédaction des étapes. L’objectif est d’éviter de devoir faire défiler l’écran pour pouvoir lire tout le texte des étapes d’une section. De plus, les textes longs engendrent une certaine lassitude. Faites en sorte que l’utilisateur soit captivé et ait envie de poursuive le tutoriel jusqu’au bout.

Exemple : dans le cadre d’un tutoriel sur la manipulation de formes dans Illustrator, vous pourriez utiliser les sections suivantes :

• Création d’une forme
• Modification de la forme
• Arrondissement des coins
• Ajout d’autres formes
• Assemblage de _______
• Association de formes

Commencez chaque étape par un verbe d’action indiquant à l’utilisateur ce qu’il doit faire.

• Exemple à suivre : Cliquez sur l’icône Plus pour étendre la sélection.
• Exemple à ne pas suivre : Si l’outil n’a pas sélectionné l’objet entier, cliquez sur l’icône Plus pour étendre la sélection.

Indiquez des valeurs approximatives dans les étapes.

• Indiquez une valeur approximative pour chaque curseur ou champ numérique que vous demandez à l’utilisateur de modifier.
• Exemple à suivre : Faites glisser le curseur Clarté jusqu’à environ +20 pour augmenter le contraste des tons moyens.

Indiquez le « pourquoi » des étapes.

• Types de « pourquoi » à inclure :
  • Le résultat d’une consigne
  • Les raisons d’utiliser un workflow ou un outil spécifique
• Exemples :
  • Résultat de la consigne :
    • Exemple à suivre : Faites glisser le curseur Opacité jusqu’à environ 80 pour accentuer la transparence de l’illustration.
    • Exemple à suivre : Réglez l’épaisseur du pinceau sur environ 50 de sorte qu’il soit légèrement plus large que la zone à corriger.
    • Exemple à ne pas suivre : Faites glisser le curseur Opacité jusqu’à environ 80.
  • Raisons d’utiliser un workflow ou un outil spécifique :
    • Exemple à suivre : Tracez une zone de texte pour le paragraphe. Le texte Paragraphe se déploie à l’intérieur de la zone, ce qui est utile lorsque vous avez beaucoup de texte à ajouter.

Utilisez des notes pour spécifier certains « pourquoi ».

• Si l’espace d’une étape est insuffisant pour insérer des « pourquoi » importants, ajoutez juste après une note sans action contenant le « pourquoi ». Veillez toutefois à utiliser les notes avec parcimonie, car l’objectif est d’inciter l’utilisateur à interagir en cliquant dans le tutoriel.
  • Exemple à suivre :
    • Étape : Dans le panneau Calques, cliquez sur l’icône Rechercher l’objet.
    • Note : Le contenu sélectionné dans le document s’affiche dans le panneau Calques.
• N’incluez pas de suggestions de workflows alternatifs, en particulier dans les tutoriels pour débutants.
  • Exemple à ne pas suivre : Pour ajouter un calque de réglage, vous pouvez aussi accéder au panneau Réglages et cliquer sur l’icône de ce calque de réglage.