====== Classroom50: Hilfe und Dokumentation ======

<WRAP center round tip 60%>
Die ausführliche Dokumentation liegt **nicht mehr im Wiki**, sondern direkt beim
Autograder:

**[[https://github.com/BZZ-Commons/pygrader50/tree/main/docs|github.com/BZZ-Commons/pygrader50/docs]]**

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

===== Was steht wo? =====

^ Wo ^ Was ^
| [[.:setup]], [[.:classes]], [[.:assignments]], [[.:moodle_simple]] | Die vier BZZ-Schritte: Organisation, Klasse, Assignment, Moodle sync |
| [[https://github.com/BZZ-Commons/pygrader50/tree/main/docs|pygrader50/docs]] | Alles andere: Konzept, Bewertung, Betrieb, Fehlersuche, CLI |

===== Wo fange ich an? =====

^ Rolle ^ Seite in der Dokumentation ^
| Du gibst Aufgaben ab | [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/lernende.md|Für Lernende]] |
| Du betreust eine laufende Klasse | [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/betrieb.md|Betrieb]] · [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/troubleshooting.md|Fehlersuche]] |
| Du richtest eine neue Klasse ein | [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/konzept.md|Konzept]] → [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/einrichtung.md|Einrichtung]] |
| Du kommst von GitHub Classroom | [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/migration.md|Migration]] |
| Du baust eine neue Aufgabe | [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/template.md|Aufgaben-Template]] → [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/bewertung.md|Bewertung]] |
| Du entwickelst an der Engine | [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/konzept.md|Konzept]] · [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/cli.md|CLI-Referenz]] |

===== Alle Seiten =====

  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/konzept.md|Konzept]] — wie Classroom 50 die Engine aufruft, welche Repos beteiligt sind
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/bewertung.md|Bewertung]] — ''unittests.json'', ''lint.json'', ''pylintrc'', wie Punkte entstehen
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/template.md|Aufgaben-Template]] — was in ein Template-Repo gehört und was nicht
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/einrichtung.md|Einrichtung]] — einen Classroom von Grund auf anschliessen
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/betrieb.md|Betrieb]] — Roster, Aufgaben, Nachbewerten, Betriebsfallen
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/moodle.md|Moodle]] — Notenübertrag, Zugangsdaten, Zuordnung der Personen
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/migration.md|Migration]] — Umstieg von GitHub Classroom
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/cli.md|CLI-Referenz]] — alle Kommandos, Optionen, Umgebungsvariablen
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/lernende.md|Für Lernende]] — Aufgabe annehmen, bearbeiten, abgeben
  * [[https://github.com/BZZ-Commons/pygrader50/blob/main/docs/troubleshooting.md|Fehlersuche]] — Symptom → Ursache

<WRAP center round important 60%>
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''.
</WRAP>