Ajouter une note contextuelle

Comment ça fonctionne

Une note contextuelle est un petit symbole coloré — i, !, ? ou * — placé à l'intérieur d'une phrase dans un bloc Texte. Les mots qu'il cache restent invisibles jusqu'à ce qu'un étudiant les demande, et Alva Courses enregistre la note avec le texte de la leçon pour qu'elle suive le paragraphe auquel elle appartient.

Le panneau qui s'ouvre contient un titre en gras facultatif et une ou deux phrases en texte brut. Rien n'est ajouté à la page elle-même, et c'est tout l'intérêt : la leçon a la même longueur qu'elle porte deux notes ou vingt.

Trois styles, quatre symboles

Le style détermine la couleur du symbole, et cette couleur est le sens que l'étudiant lit avant même d'ouvrir quoi que ce soit. Alva Courses vous en propose trois.

• Info est bleu — une définition, une unité, un chiffre, tout ce qui est neutre.
• Conseil est vert — un raccourci, une préférence, quelque chose qui facilite l'étape.
• Avertissement est ambre — l'erreur que les étudiants commettent ici, et comment l'éviter.

Les trois couleurs sont fixes. Elles ne fonctionnent comme signaux que si un avertissement ressemble à un avertissement dans chaque leçon de chaque cours : elles ne suivent donc pas les couleurs de votre cours. Le symbole se choisit séparément et n'est rien d'autre que le caractère affiché dans la pastille.

Quand utiliser une note plutôt qu'un encadré

Une note sert au détail dont seuls certains de vos étudiants ont besoin, et ce choix relève de l'écriture plutôt que d'un réglage. Utilisez-en une lorsque :

• un terme demande une définition d'une ligne que la plupart de la classe connaît déjà ;
• une étape comporte une réserve qui ne vaut que pour une configuration, un pays ou un niveau ;
• vous voulez répondre, sur place, à la question que quelques étudiants vous posent toujours par e-mail.

Utilisez un encadré mis en évidence ou un simple nouveau paragraphe lorsque tous les étudiants doivent lire ces mots. Une note est facultative — un étudiant qui ne survole jamais ne la voit jamais — donc rien de ce qui change ce que quelqu'un achète, paie ou doit faire n'a sa place derrière une note. La même règle garde les leçons lisibles : un paragraphe qui contient six symboles est plus difficile à lire que ne l'aurait été la version longue.

Rédiger des notes que les étudiants liront

Limitez une note à une ou deux phrases. Le panneau est dimensionné pour un aparté, pas pour un paragraphe, et la limite de 500 caractères est généreuse par rapport à ce qui se lit vraiment bien sur un téléphone. Utilisez le titre comme une étiquette plutôt que comme une phrase — « Unités métriques uniquement », « Si vous utilisez Shopify Payments », « Avant de commencer » — pour qu'un étudiant sache si la note le concerne avant de la lire.

Le corps est en texte brut. Les liens, les images et la mise en forme ne sont pas disponibles dans une note, et c'est délibéré : tout ce sur quoi un étudiant doit cliquer a sa place dans la leçon, là où il le verra.

Les notes dans les exports PDF et la recherche

Le papier ne permet pas le survol. Lorsqu'un cours est exporté en PDF, Alva Courses masque le symbole et imprime la note dans le texte, entre crochets, le titre en premier — « … vérifiez vos réglages [Avant de commencer : les unités doivent être métriques.] … » — pour que rien de ce que vous avez écrit ne soit perdu dans la version imprimée.

Le texte des notes est également indexé par la recherche dans les leçons. Un étudiant qui cherche un mot présent uniquement dans une note retrouve quand même la leçon où il est caché.

Modifier ou retirer une note

Dans l'éditeur de leçon, cliquez sur une note existante pour rouvrir la fenêtre avec son style, son symbole, son titre et son texte actuels. Modifiez ce qui doit l'être puis cliquez sur Enregistrer, ou cliquez sur Retirer la note pour enlever le symbole en laissant la phrase intacte. Enregistrez la leçon pour publier le changement.