Wie wir Lektionen bauen
Jede Lektion durchläuft denselben Weg, bevor sie erscheint.
Die Pipeline
1Spezifikation
Ein Mensch beschreibt, was die Lektion lehren muss: das Ziel, die unverzichtbaren Begriffe, die Art der Übung und was ausdrücklich nicht dazugehört.
2Entwurf
Der Entwurf entsteht nach dieser Spezifikation. Seine Struktur wird maschinell geprüft: Eine Lektion ohne Theorieblöcke, Übung oder Hinweise kommt nicht durch.
3Validierung
Automatische Prüfungen kontrollieren Struktur, Voraussetzungsgraph und dass kein Text außerhalb der Übersetzungsdateien fest verdrahtet ist.
4Fachliche Prüfung
Aussagen werden auf sachliche Richtigkeit geprüft. Vereinfachen ist erlaubt; schlicht Falsches nicht.
5Übersetzung
Jede Lektion wird mit einem festen Glossar übersetzt, damit die Terminologie im ganzen Kurs einheitlich bleibt.
6Veröffentlichung
Eine Lektion erscheint nur, wenn alle Prüfungen bestehen. Scheitern sie, scheitert der Build — fehlerhafte Inhalte erreichen die Seite nicht.
Was automatisch geprüft wird
Jede Lektion muss einem Schema entsprechen, jede Voraussetzung muss existieren, jede Aufgabe mindestens zwei Hinweise haben, jede sichtbare Zeichenkette in allen Sprachen vorliegen und jeder Simulationswert zum beschreibenden Text passen.
Grenzen, ehrlich benannt
Lektionen entstehen mit maschineller Unterstützung und werden danach geprüft. Fehler sind also möglich, und wir sagen das lieber, als es zu verschweigen. Wer einen findet, soll ihn melden — Korrekturen kommen in die Lektion, nicht unter den Teppich.