Versionnement des contenus et des formations

Une formation n’est jamais figée : on corrige une faute, on ajoute un chapitre, on remplace une question de quiz. Le problème, c’est que des apprenants sont parfois déjà inscrits et ont déjà répondu à des questions. Modifier la formation sous leurs pieds pourrait casser leur progression.

Le versionnement est le mécanisme qui résout ça. Il permet de faire évoluer une formation sans jamais perturber les apprenants en cours, et de décider explicitement quand leur pousser la mise à jour.

🧱 Deux choses sont versionnées : la formation et les contenus

Il faut distinguer deux niveaux, qui évoluent séparément :

	C’est quoi ?	Exemple de modification
La formation (l’arbre)	La structure du parcours : les chapitres, les modules (« étapes ») et leur ordre.	Ajouter un chapitre, déplacer un module, supprimer une étape.
Le contenu	Un module individuel avec lequel l’apprenant interagit : un quiz, une vidéo, une page, etc.	Modifier une question d’un quiz, changer une réponse.

Chaque formation est composée d’étapes, et chaque étape pointe vers un contenu dans une version précise. C’est cette mécanique qui permet de mettre à jour un quiz sans toucher au reste du parcours, et inversement.

🔢 Version majeure et version mineure

Chaque formation et chaque contenu portent un numéro de version en deux parties : majeure.mineure (par exemple 1.3).

Type	Quand l’utiliser ?	Effet
Mineure	Une correction sans risque pour les apprenants (faute d’orthographe, reformulation, ajout d’une information).	La version est mise à jour sur place.
Majeure	Un changement qui pourrait perturber un apprenant déjà inscrit.	Une nouvelle version est créée. L’ancienne reste intacte.

Le point essentiel : une version majeure ne remplace jamais l’ancienne. Elle vient s’ajouter à côté. Les apprenants déjà inscrits continuent de voir l’ancienne version tant qu’on ne les a pas synchronisés (voir plus bas). C’est ce qui rend les modifications sûres.

⚠️ Qu’est-ce qu’un changement « cassant » ?

Un changement est dit cassant (ou « breaking ») lorsqu’il risque d’invalider la progression d’un apprenant. La plateforme les détecte automatiquement. On distingue deux familles.

Côté formation (la structure)

Un changement de structure est cassant quand un module est :

➕ ajouté — une nouvelle étape apparaît dans le parcours ;
➖ retiré — une étape est supprimée ;
↕️ déplacé — une étape change de place dans l’arbre.

Côté contenu (le quiz)

Pour un quiz, est considéré comme cassant :

une question supprimée — la réponse de l’apprenant à cette question n’a plus de sens ;
une question remplacée — la réponse existante ne correspond plus à la nouvelle question ;
une question ajoutée — une nouvelle question pour laquelle l’apprenant n’a pas encore répondu ;
une réponse supprimée ou dont la valeur change dans une question — la réponse enregistrée peut devenir invalide.

Ce qui n’est pas cassant

Renommer une question ou une réponse (la valeur reste la même).
Réordonner des questions ou des réponses.
Modifier une description, un texte d’aide, une consigne.

Ces modifications peuvent être enregistrées en mineure sans aucun risque.

💾 À la sauvegarde : la détection automatique

Pendant l’édition, un indicateur visuel signale en temps réel la nature des modifications en cours :

🟢 « Modifications mineures » — rien de cassant, une sauvegarde en mineure est recommandée ;
🟠 « N modification(s) majeure(s) » — au moins un changement cassant a été détecté, une version majeure est recommandée.

Si l’on tente d’enregistrer en mineure alors que des changements cassants existent, une fenêtre « Modifications majeures détectées » s’ouvre. Elle :

liste les changements détectés en clair, par exemple :
- Question supprimée : « Quel est le diagnostic ? »
- Question ajoutée : « Quel traitement ? »
- Étape supprimée : « Introduction »
demande une justification écrite pour passer outre et sauvegarder quand même en mineure.

Cette justification est conservée dans un journal d’audit : on sait toujours qui a forcé une mineure malgré un changement cassant, et pourquoi.

📌 Le « pinning » : pourquoi les apprenants ne cassent jamais

Le mécanisme qui protège les apprenants s’appelle le pinning (« épinglage »).

Quand un apprenant démarre une formation, il est épinglé à la version majeure du moment. À chaque fois qu’il ouvre son parcours, la plateforme lui sert exactement la version sur laquelle il a commencé — même si une, deux ou trois versions majeures plus récentes existent désormais en base.

Conséquence directe : modifier une formation (et créer une nouvelle majeure) n’a aucun effet visible pour les apprenants déjà inscrits. Ils restent sur leur version, leur progression est intacte, rien ne bouge sous leurs pieds.

🔄 Et après ? La synchronisation

Détecter un changement et le propager sont deux choses différentes.

Tant qu’on ne fait rien, les apprenants déjà inscrits restent sur leur ancienne version (grâce au pinning). Pour leur faire bénéficier de la mise à jour, un employé doit explicitement lancer la synchronisation, avec un aperçu complet et un contrôle apprenant par apprenant.

👉 Voir la page dédiée : Synchronisation des formations.

🔐 Conditions d’accès

Le versionnement fait partie des outils d’édition back-office (outil auteur, gestion du catalogue), réservés aux employés. Le rôle minimal exact est à confirmer avec l’équipe produit.