Règle 1
L'auto-portance
Une fiche doit permettre de finir la tâche sans ouvrir un autre document. Copier ce qu'il faut est un bon réflexe.
Lire la règleCe livre blanc rassemble les règles de conception du matériel pédagogique, une page par règle. Chaque règle est née d'un cas réel de cours, elle en garde la trace, et elle dit comment l'appliquer et comment vérifier qu'elle l'est.
Le mot
Whitebook n'existe pas en anglais, où l'on dit white paper. Il existe depuis le 11 septembre 2026, jour où il a reçu une adresse et un certificat. Et il dit mieux la chose : un white paper se lit une fois, un livre s'augmente.
À qui il sert
Aux prochaines instances d'assistance qui travaillent sur les sites de cours, les fiches et les diaporamas : elles doivent connaître ces règles dès leur première minute, sans avoir à les redécouvrir par tâtonnement. Et aux autres projets de la maison, parce qu'une règle qui tient pour une fiche d'installation tient aussi pour une page de vente, un tutoriel ou un jeu.
Chaque page est un fichier HTML autonome : son style et son comportement sont embarqués, elle s'ouvre au clic, elle s'imprime, elle se transporte sur une clé. C'est la règle 1 appliquée à elle-même.
Les règles
Règle 2
Un mot, plusieurs portes
Quand un verbe se répète dans une liste de liens, il s'écrit une fois et porte des sous-pilules. Et on mesure avant de publier.
Lire la règleRègle 3
Un document augmenté reste fidèle à lui-même
Quand on ajoute à un document existant, ce qui existait ne change pas, ce qu'on ajoute en adopte la forme, et la fidélité se mesure.
Lire la règleRègle 4
Une URL Drive se convertit en chemin local
Une adresse Google Drive n'est pas un endroit où travailler : on la traduit d'abord en chemin local sur le montage, par un script qui part de l'identifiant, jamais en cliquant.
Lire la règleRègle 5
Le défi précède la loi
Un défi ne nomme jamais la notion que l'étudiant n'a pas encore vue : il pose le problème, et c'est la solution qui révèle le nom de la loi qu'on vient d'appliquer.
Lire la règleRègles candidates
Des principes déjà appliqués dans les faits, qui attendent leur page :
À écrire
Un script plutôt qu'une manipulation
Toute retouche de site se fait par un script idempotent gardé dans le répertoire du cours, pour que la deuxième fois coûte une commande.
À écrire
Ne jamais effacer, toujours déplacer
Un contenu qui sort d'une page reste en ligne à son adresse. On retire des liens, pas des fichiers.