Quest Ladder
TeachFORGE.ai
Quest Ladder / Vorschau und Verifizierung
Vorschau, neue Beispiele und Render-Verifizierung
Sehen Sie mehrmals, was ein Lernender tatsächlich bekommt, bevor es jemand anderes sieht.
Ein Typ, den Sie nicht getestet haben, ist ein Typ, den Sie nicht geschrieben haben.
Vorschau und Verfeinerung
Das Überprüfungs -Stufe öffnet auf Vorschau und KI-Verfeinerung: eine echte generierte Instanz Ihres Typs, gerendert so, wie ein Lernender sie sehen würde.
- Vorschau aktualisieren rendert das aktuelle Beispiel nach einer Bearbeitung neu.
- Neue Beispiele erzeugt neue Werte, sodass Sie eine andere Version sehen. Es ist beschriftet mit Beispiel 1, Beispiel 2 und so weiter.
- Ein Schalter wechselt zwischen der Token-Vorlage und der aufgelösten Vorschau, die der Schüleransicht entspricht.
Drücken Sie Neue Beispiele mindestens fünfmal, bevor Sie irgendetwas Parametrisches veröffentlichen. Schlechte Kombinationen verstecken sich: die Division, die viermal glatt aufgeht und beim fünften Mal unschön ist, das Diagramm, das sich nur überlappt, wenn zwei Variablen beide groß sind. Ein einziges Beispiel beweist nichts.
Render-Verifizierung
Die Render-Verifizierung prüft, dass jeder Teil des Typs tatsächlich gezeichnet wird: Das LaTeX kompiliert, das Diagramm rendert, das Diagramm hat seine Daten, kein Block schlägt fehl. Das Badge meldet einen von vier Zuständen.
| Badge | Bedeutung |
|---|---|
| Verifiziert — einwandfrei | Alles wurde gerendert. |
| Erneute Verifizierung nötig | Es war einwandfrei, dann haben Sie etwas bearbeitet. Führen Sie es erneut aus. |
| {{count}} Render-Fehler | Etwas wird nicht gezeichnet. Die Liste sagt, was. |
| Noch nicht verifiziert | Es wurde noch nie überprüft. |
Das ist eine Sperre, keine Warnung. Die Veröffentlichung wird verweigert, solange Fehler bestehen, und die Steuerung sagt auch, warum: Beheben Sie die Render-Verifizierungsfehler vor der Veröffentlichung.
Was die Fehler meist sind
Drei Ursachen machen die meisten davon aus.
- Ein LaTeX- oder TikZ-Ausdruck mit einem Syntaxfehler, oft durch eine verirrte Klammer nach einer Bearbeitung.
- Ein Token, das auf eine Variable verweist, die inzwischen umbenannt oder gelöscht wurde, sodass sich nichts auflöst.
- Ein Diagramm, dessen Koordinaten aus Variablen stammen, die einen Entartungsfall erzeugen können — ein Dreieck ohne Fläche, ein Diagramm ohne Wertebereich.
Der dritte ist der, auf den man achten sollte, denn er besteht bei den meisten Beispielen. Ein Verifizierungslauf, der mehrere Wertesätze durchprobiert, ist das, was ihn findet, und genau das ist der Fehler, dem ein Lernender bei einer von zwanzig Malen begegnen würde.
Als bereit markieren
Als bereit markieren setzt den Status auf veröffentlicht, sobald Sie mit der Vorschau der Beispiele zufrieden sind. Das ist der Moment, in dem der Typ gelistet und zuweisbar wird — siehe Veröffentlichen, zurückziehen und die Vollständigkeits-Chips für das, was sich dadurch ändert.