Kurs einreichen

Der fertige, lokal getestete Kurs geht als GitLab Merge Request in die Überprüfung. Diese Lektion beschreibt die Vorbereitung, den Merge Request selbst und den anschließenden Prüfungsprozess.

Den Kurs zur Einreichung vorbereiten

Vor der Einreichung gilt:

1. alle Kursinhalte sind vollständig und getestet
2. der Kurs folgt der Struktur und den Richtlinien aus den vorherigen Lektionen
3. alle Mediendateien (Bilder, Videos) sind richtig abgelegt und referenziert
4. die Kursmetadaten im Frontmatter sind korrekt und vollständig

Einen Merge Request erstellen

1. Änderungen committen:

   git add .
   git commit -m "Neuen Kurs hinzugefügt: <Ihr Kursname>"
   

2. Branch pushen:

   git push origin courses/<Ihr-Kursname>
   

3. Merge Request anlegen:

   • das GitLab-Repository im Browser öffnen
   • auf Create merge request klicken (die Schaltfläche erscheint meist direkt nach dem Push)
   • andernfalls im Bereich Merge requests auf New merge request klicken

4. Merge Request ausfüllen:

   • Quell-Branch: der Kurs-Branch
   • Ziel-Branch: main
   • Titel, z. B. „Neuer Kurs: Einführung in Git“
   • in der Beschreibung ein kurzer Überblick über den Kurs und alle relevanten Informationen für die Prüfenden

5. Merge Request einreichen:

   • alle Änderungen ein letztes Mal durchsehen
   • auf Create merge request klicken

Der Prüfungsprozess

Nach dem Einreichen:

1. Prüfende sehen sich Inhalt, Struktur und Einhaltung der Richtlinien an
2. daraus können Feedback oder Änderungswünsche entstehen
3. Änderungen auf Basis des Feedbacks fließen in denselben Merge Request
4. nach der Freigabe wird der Kurs in den Haupt-Branch integriert und veröffentlicht

Best Practices für Merge Requests

• Schnell reagieren: Den Merge Request regelmäßig auf Kommentare prüfen.
• Offen für Feedback bleiben: Die Prüfung sichert die Qualität der Inhalte. Verbesserungsvorschläge sind Teil davon.
• Nach Änderungen testen: Jede Änderung aus dem Feedback vor dem Push lokal testen.

Übung: Den Kurs einreichen

1. den gesamten Kurs ein letztes Mal durchsehen
2. alle Änderungen committen und den Branch pushen
3. einen Merge Request nach den obigen Schritten erstellen
4. in der Beschreibung kurz zusammenfassen, worum es im Kurs geht und was Lernende erwartet

Damit ist der gesamte Prozess vom Anlegen bis zum Einreichen eines Kurses durchlaufen. Die letzte Lektion fasst zusammen und zeigt nächste Schritte für Kursautorinnen und -autoren.