Rédiger une unité
Rédige les ressources d'une unité. Lisez COURSE-CANVAS.md, PLAN.md, PERSONAS.md, RESOURCES.md, DECISIONS.md ainsi que le contenu de l'unité précédente. Utilisez la structure existante des fichiers du cours (titres, tableaux, ton) ; si le cours n'en a pas encore, proposez-en une et attendez la confirmation.
1. Écrire le parcours en premier
Avant tout contenu, rédigez le parcours de l'apprenant pour l'unité sous forme de liste numérotée dans les notes de l'instructeur du fichier de session : chaque étape que l'apprenant suit, de l'ouverture de la page participant à la remise du livrable, avec pour chacune :
- ce dont il a besoin (concept, outil, fichier, lien, compte) et d'où cela provient (limite, unité antérieure, cette page),
- le résultat attendu qu'il peut voir.
Chargez assumed-knowledge. Une étape dont le besoin n'a pas d'origine est une lacune : résolvez-la immédiatement en ajoutant une étape, un lien ou une explication, ou bien transmettez-la à l'instructeur. Affichez le parcours et attendez une confirmation ; c'est la spécification par rapport à laquelle le contenu est vérifié.
2. Rédiger
Rédigez ce dont l'unité a besoin selon RESOURCES.md, chaque élément dans son emplacement propre :
- Instructeur : plan de session avec horaires, input, travail en groupe, exemples de réponses et points de discussion. Rédigez les blocs d'input sous forme de contenu (affirmations, chiffres, exemples) en gardant les notes de l'intervenant à l'esprit ; les diapositives en seront dérivées plus tard par
/to-slides. - Participant : objectifs, tâches, livrable, contenu avec longueurs. Chargez
learner-instructions. - Modèle ou code : notebooks, données, configuration dont les tâches dépendent.
Calculez les exemples de réponses en exécutant le code sur les données du cours, jamais de mémoire. Citez les chiffres avec leur mode de calcul.
3. Point d'arrêt
Affichez les brouillons avec une courte liste des choix que vous avez faits (formulation des tâches, choix de la vidéo, degré d'optionalité) et ce sur quoi vous n'étiez pas sûr. L'instructeur modifie ou approuve. Consignez les choix qui affectent d'autres unités dans DECISIONS.md.
Terminé lorsque l'instructeur a approuvé les brouillons et que RESOURCES.md liste l'unité comme brouillon. Suggérez /to-slides <unité> si la session contient des blocs d'input, puis /walk-through <unité> ; ne marquez jamais une unité comme publiée dans ce skill.