Méthodologie de production¶
Toutes les formations de cette plateforme sont produites selon le même processus. Il est décrit ici pour que le lecteur sache ce qu'il tient entre les mains, et à quelles vérifications le contenu a été soumis.
Le principe¶
Un corpus enseigne les décisions, pas les commandes. La documentation d'un produit explique ce que fait une option ; une formation doit expliquer pourquoi on la choisit, ce que ce choix coûte, ce qu'il écarte et quel risque il laisse ouvert. Chaque arbitrage important porte donc quatre éléments : la décision, son coût, l'alternative écartée et le critère qui justifierait de la reconsidérer.
Le cycle¶
La production suit douze phases : cadrage, conception pédagogique, architecture du corpus, rédaction, vérification technique, relecture, audit contradictoire, correction, contrôle de régression, gel, empaquetage, livraison.
Les trois phases de rédaction, de vérification et de relecture forment une boucle interne exécutée partie par partie. L'audit, la correction et le contrôle de régression forment une boucle externe sur l'ensemble.
Les contrôles¶
Vérification technique : chaque commande, version, paramètre et chiffre est contrôlé ; ce qui ne peut pas l'être est déclaré comme tel.
Relecture : dix passes distinctes, dont une relecture pédagogique qui vérifie qu'aucune notion n'est utilisée avant d'être définie, que chaque renvoi prospectif est tenu, et que chaque chapitre porteur d'un choix contient un arbitrage explicite.
Audit contradictoire : une passe adverse, instrumentée, dont l'objectif déclaré est de faire échouer le corpus plutôt que de le valider. Les défauts sont classés par gravité et localisés.
Gel : une fois validé, un corpus ne change plus. Sa publication est produite automatiquement à partir des fichiers gelés, sans aucune modification de leur texte.
L'honnêteté sur le périmètre¶
Un corpus déclare ce qu'il fournit et ce qu'il ne fournit pas. Les fiches de formation de cette plateforme indiquent explicitement les livrables restant à produire. Aucune formation n'est présentée comme complète tant qu'elle ne l'est pas.
Cette plateforme¶
Le site est une couche de publication : les sources de chaque formation sont gelées et vérifiées par empreinte à chaque construction. Le découpage en pages, la conversion des renvois en liens et la navigation sont produits automatiquement. Un contrôle compare la suite des mots des sources à celle des pages publiées afin de garantir qu'aucun contenu n'a été perdu ni altéré.