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ègles candidates
Des principes déjà appliqués dans les faits, qui attendent leur page :
À écrire
Publier les originaux, pas les recopies
Les diaporamas du cours se publient en images de l'original, jamais refaits à la main : l'auteur garde la main sur son matériel et rien ne se perd à la conversion.
À é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.