Logo

Verstehen der Kursstruktur

Verstehen der Kursstruktur

In dieser Lektion werden wir die Struktur eines git.nrw-Kurses und seine verschiedenen Komponenten erkunden. Das Verständnis dieser Struktur ist entscheidend für die Erstellung gut organisierter und effektiver Kurse.

Kurskomponenten

Ein typischer git.nrw-Kurs besteht aus den folgenden Komponenten:

  1. Kursübersichtsseite
  2. Lektionen
  3. Kursabschnitte
  4. Medien und Ressourcen

Lassen Sie uns jede dieser Komponenten im Detail betrachten.

1. Kursübersichtsseite

Die Kursübersichtsseite (_index.md) dient als Hauptzugangspunkt für Ihren Kurs. Sie enthält:

  • Kursmetadaten (Titel, Beschreibung, Tags usw.)
  • Kursziele
  • Voraussetzungen
  • Eine kurze Einführung in den Kurs

2. Lektionen

Lektionen sind individuelle Markdown-Dateien, die den eigentlichen Kursinhalt enthalten. Jede Lektion sollte:

  • Einen klaren Titel und eine Beschreibung haben
  • Teil eines Kursabschnitts sein
  • Relevante Inhalte, Beispiele und Übungen beinhalten

Empfohlene Grundstruktur einer Lektion

Nicht jede Lektion braucht dieselbe starre Vorlage. Sinnvoller ist es, mit wenigen Bausteinen bewusst zu arbeiten:

  • ein kurzer Einstiegssatz, der die Lektion einordnet
  • ## Goal nur dann, wenn die Lektion einen konkreten Arbeitsauftrag hat
  • ## Do für die eigentliche Erklärung oder Schrittfolge
  • ## Takeaway für eine verdichtete Regel oder ein mentales Modell
  • ## Check als letzter Selbsttest-Block der Lektion

So bleiben Lektionen konsistent, ohne schablonenhaft zu wirken.

Wann Goal sinnvoll ist

Verwenden Sie ## Goal, wenn Lernende etwas Konkretes tun sollen, zum Beispiel:

  • ein Werkzeug installieren
  • einen Zugang konfigurieren
  • Dateien anlegen oder bearbeiten
  • einen Workflow validieren oder ausführen

Nicht jede Lektion braucht ein ## Goal. Bei kurzen konzeptionellen Lektionen reicht oft ein knapper Einstieg.

Wo Check hingehört

Wenn Sie ## Check verwenden, sollte dieser Abschnitt am Ende der Lektion stehen und den letzten inhaltlichen Block bilden.
## Takeaway gehört davor, nicht danach.

Diese Reihenfolge funktioniert gut:

  1. Thema erklären oder zeigen
  2. zu einer Merkhilfe verdichten
  3. prüfen lassen, ob Lernende es erklären oder anwenden können

Abschluss- oder Übungslektionen

Bei größeren Übungslektionen ist es hilfreich, operative Prüfung und reflektierenden Selbsttest zu trennen:

  • verwenden Sie z. B. ## Verify your result für konkrete Erfolgskriterien
  • verwenden Sie ## Check für Reflexionsfragen oder kurze Selbsttests

So bekommt ein Abschnitt nicht zwei unterschiedliche Aufgaben gleichzeitig.

3. Kursabschnitte

Kursabschnitte helfen dabei, Lektionen in logische Gruppen zu organisieren. Sie können folgende Elemente repräsentieren:

  • Kapitel in Ihrem Kurs
  • Fähigkeitsstufen (z. B. Anfänger, Fortgeschrittene, Fachkundige*r)
  • Thematische Einheiten

4. Medien und Ressourcen

Um Ihren Kurs zu verbessern, können Sie Folgendes einfügen:

  • Bilder
  • Videos
  • Herunterladbare Ressourcen (z. B. PDFs, Codebeispiele)

Dateistruktur

Eine typische Kursdateistruktur sieht so aus:

content/
└── de/
    └── courses/
        └── ihr-kursname/
            ├── _index.md
            ├── 010-010-einführung.md
            ├── 010-020-weiterleitungen.md
            ├── 020-010-fortgeschrittenes-thema.md
            └── ...

Für mehrteilige Kurse ist eine verschachtelte Struktur oft leichter zu pflegen:

content/
└── de/
    └── courses/
        └── ihr-kursname/
            ├── _index.md
            ├── 10-einstieg/
            │   ├── _index.md
            │   ├── 10-erster-schritt.md
            │   └── 20-zweiter-schritt.md
            ├── 20-kern-workflow/
            │   ├── _index.md
            │   └── 10-hauptaufgabe.md
            └── 30-abschlussuebung/
                ├── _index.md
                └── 10-capstone.md

Diese Struktur eignet sich besonders dann, wenn Kursabschnitte in der Sidebar klar sichtbar sein sollen und mehrere Lektionen zu einer zusammenhängenden Phase gehören.

Nächste Schritte

Jetzt, da Sie die Struktur eines git.nrw-Kurses verstehen, werden wir im nächsten Kapitel damit beginnen, Ihre Kursinhalte zu planen. Dies wird Ihnen helfen, Ihre Ideen zu organisieren und einen Fahrplan für die Entwicklung Ihres Kurses zu erstellen.