Classroom50: Hilfe und Dokumentation

Die ausführliche Dokumentation liegt nicht mehr im Wiki, sondern direkt beim Autograder:

github.com/BZZ-Commons/pygrader50/docs

Dort wird sie zusammen mit der Engine gepflegt und ist damit immer auf dem Stand der eingesetzten Version.

Was steht wo?

Wo	Was
Classroom50: Organisation einrichten, Classroom50: Classroom erstellen, Classroom50: Assignment erstellen, Classroom50: Moodle sync einrichten	Die vier BZZ-Schritte: Organisation, Klasse, Assignment, Moodle sync
pygrader50/docs	Alles andere: Konzept, Bewertung, Betrieb, Fehlersuche, CLI

Wo fange ich an?

Rolle	Seite in der Dokumentation
Du gibst Aufgaben ab	Für Lernende
Du betreust eine laufende Klasse	Betrieb · Fehlersuche
Du richtest eine neue Klasse ein	Konzept → Einrichtung
Du kommst von GitHub Classroom	Migration
Du baust eine neue Aufgabe	Aufgaben-Template → Bewertung
Du entwickelst an der Engine	Konzept · CLI-Referenz

Alle Seiten

Konzept — wie Classroom 50 die Engine aufruft, welche Repos beteiligt sind
Bewertung — unittests.json, lint.json, pylintrc, wie Punkte entstehen
Aufgaben-Template — was in ein Template-Repo gehört und was nicht
Einrichtung — einen Classroom von Grund auf anschliessen
Betrieb — Roster, Aufgaben, Nachbewerten, Betriebsfallen
Moodle — Notenübertrag, Zugangsdaten, Zuordnung der Personen
Migration — Umstieg von GitHub Classroom
CLI-Referenz — alle Kommandos, Optionen, Umgebungsvariablen
Für Lernende — Aufgabe annehmen, bearbeiten, abgeben
Fehlersuche — Symptom → Ursache

Die Dokumentation ist schulunabhängig geschrieben und verwendet Platzhalter wie <ORG> oder <CLASSROOM>. An der BZZ ist <ORG> die Organisation des Moduljahrgangs, z.B. m320-ix25.