ADR-0003 — Découpler contenu, parcours et provider

Source : project/adr/ADR-0003-decoupler-contenu-parcours-provider.md
Identifiant : [DOC-ADR-003]
Version : 0.1
Dernière modification : 2026-06-12
Statut : acceptée

Décision

Un contenu pédagogique stable ne doit pas dépendre de sa position dans un parcours ni d’un provider utilisé pour l’illustrer.

On distingue donc :

Couche	Rôle	Exemple
Contenu stable	Notion ou micro-module réutilisable	[MIC-CTX-001] Contexte utile
Parcours	Sélection et ordre des contenus	Rencontre 1, Rencontre 2, Rencontre 3
Présentation	Libellé visible dans une page ou une navigation	Rencontre 1 — Contexte utile
Provider	Outil utilisé pour illustrer ou pratiquer	GitHub Copilot, Codex, Claude Code

Règles

Identité du contenu

Le titre stable du contenu ne contient pas son ordre de présentation.

Préférer :

Contexte utile
Cartographier un codebase
Vérifier une réponse IA

Éviter :

Cours 1 - Contexte utile
Cours 2 - Cartographier un codebase
Cours 3 - Vérifier une réponse IA

Ordre de présentation

L’ordre appartient au parcours, à la page d’index ou à la navigation.

Une page peut être affichée comme Rencontre 1 dans un parcours donné, mais cette numérotation ne fait pas partie de l’identité du contenu.

Provider

Un provider ne doit pas devenir un tag principal lorsque la notion est transversale.

Préférer :

20–30 min · Notion transversale · Prompt et contexte

Éviter :

20–30 min · GitHub Copilot · Prompt et contexte

Conséquences

• Les pages publiques gardent des titres stables.
• La page /cours peut afficher un ordre de rencontres sans modifier l’identité des contenus.
• Les menus peuvent utiliser un libellé de parcours pour afficher l’ordre courant.
• Les métadonnées visibles décrivent d’abord la notion.
• Les providers restent documentés dans les références pédagogiques ou les sections d’équivalence.
• Le même contenu peut être repris dans un autre parcours sans être renommé.