GitHub Classroom automatisiert das Verteilen dieser Vorlage: Statt dass jedes Team manuell „Use this template" klickt, erzeugt Classroom aus einem Einladungslink automatisch pro Team (oder pro Person) ein eigenes Repository — vorausgefüllt mit dem Inhalt dieser Vorlage.
Optional. Ohne Classroom funktioniert die Vorlage genauso: Teams legen ihre Kopie über den grünen „Use this template"-Button selbst an (siehe README.md). Classroom lohnt sich ab ca. 3–4 Teams oder wenn du Abgaben zentral überblicken willst.
- GitHub-Konto mit Lehrenden-Status — kostenlos über GitHub Education / Teacher. Über das GitHub Campus-Programm der HSO ist dieser Zugang in der Regel bereits gedeckt; für HSLU / extern reicht die individuelle Teacher-Verifizierung.
- Eine GitHub-Organisation für den Kurs (z. B.
hso-ebusiness-ss26). Classroom hängt immer an einer Organisation, nicht an einem Privatkonto. - Diese Vorlage als Template-Repository (Einstellung
Template repositoryist bereits aktiviert — siehe README).
github.com/organizations/new → kostenloser Plan genügt. Name z. B. nach Kurs + Semester.
classroom.github.com öffnen → New classroom → die eben erstellte Organisation auswählen.
Studierendenliste (Namen oder Matrikelnummern) als Roster hochladen. Damit ordnet Classroom später Repos den richtigen Personen zu. Kann auch leer bleiben — dann verknüpfen sich Studierende beim Annehmen selbst.
New assignment → Group assignment (für Teamprojekte; „Individual" nur für Einzelarbeiten).
- Repository prefix: z. B.
projekt→ ergibtprojekt-team-muelleretc. - Template repository: dieses Repo auswählen
(
gseilheimer/ki-projekt-template). - Sichtbarkeit:
Privateempfohlen (Abgaben kursintern). - Team-Größe: Maximum setzen (z. B. 4).
Unter Add tests lassen sich Befehle hinterlegen, die bei jedem Push laufen
(z. B. npm test). Passt zu Projekten mit Node-/Test-Stack (TDD) — die Abnahmekriterien
aus FEATURE.md werden so automatisch geprüft. Für den Einstieg nicht nötig.
Achtung — statische PWA: Eine Vanilla-PWA (wie der „Touristik Guide") hat keinen Test-Runner;
npm testgreift dort nicht. Die Abnahme erfolgt per Browser-Verifikation (DevTools), siehedocs/setup.md→ „Verifikation: PWA vs. Test-Stack". Autograding hier also weglassen oder nur auf reine Logik-Helfer (ohne Browser-APIs) beschränken.
Classroom erzeugt einen Invitation link. Diesen Link teilst du im Kurs (Moodle). Jedes Team:
- öffnet den Link,
- erstellt oder tritt einem Team bei,
- bekommt automatisch ein eigenes Repo mit dem Vorlageninhalt.
Classroom unterscheidet nicht, von welcher Hochschule jemand kommt — entscheidend ist nur ein gültiges GitHub-Konto. Damit lassen sich interne und externe Teilnehmende in derselben Classroom-Organisation führen:
| Gruppe | Zugang |
|---|---|
| HSO-Studierende | GitHub Campus (HSO) → Konto vorhanden |
| HSLU-Studierende | eigenes kostenloses GitHub-Konto |
| Externe Kursteilnehmende | eigenes kostenloses GitHub-Konto |
Für Lehrenden-Features (Classroom, Autograding-Minuten) zählt dein eigener Teacher-Status — nicht der der Teilnehmenden.
Wenn du Classroom (noch) nicht nutzen willst, genügt:
- Link zu diesem Template-Repo im Kurs teilen.
- Teams klicken „Use this template" → „Create a new repository".
- Fertig — der weitere Workflow ist identisch.
Bei Fragen zur Einrichtung: Betreuungsteam über Moodle.