Checkliste_Finalisierung.md

lang	de-de

Checkliste für die Finalisierung einer Fallstudie

Zielgruppe & Lernziele

• Zielgruppe und erforderliches Vorwissen
• Groblernziele (Kapitel)
• Feinlernziele (Section) -> Blooms Taxonomie für kognitive Lernzielformulierung verwendet
• Geschätzter Workload pro Kapitel (1-3 Stunden) festgelegt
• Geschätzter Workload pro Abschnitt (20-60 Minuten) festgelegt
• Zugangswege definiert (Book-Only und/order 🚀Cloud und/order 🚀Local)

Struktur

• Startseite
  • Kurze Beschreibung + einladendes Bild
  • Zielgruppe
  • Struktur der Fallstudie + darstellendes Bild, das die Schritte der Fallstudie als Kapitel visualisiert
  • Kurze Beschreibug aller Schritte
  • Literatur
• Präambel
  • Lernziele
  • Technische Voraussetzungen
  • Vorkenntnisse
• Struktur der Kapitel
  • Einleitung
  • Inhalt
  • Resümee
  • Assessment
• Reflexion und Resümee
• Epilog

Inhalt

• Möglichkeit zu Anmerkungen, Kommentierungen (z. B. durch die Zielgruppen)
• Fachliche Korrektheit überprüft
• Code-Beispiele (wenn skriptbasierte Sprache verwendet wird) kommentiert und verständlich
• Alle Fachbegriffe erklärt oder verlinkt
• Optionale Kapitel kennzeichnen

Assessment

• Assessment pro Kapitel (pro Zugangsweg?)
• Abschlussassessment für die OER als Ganzes

Technologie

• GitHub Action funktioniert
• Lokale Entwicklungsumgebung funktioniert
• Colab funktioniert wie angedacht
• Binder funktioniert wie angedacht
• Live Code funktioniert wie angedacht

Formatierung / Typographie / Design

• Teile sollten in Kapitel geändert werden: Es erleichtert die Navigation
• Admonitions passend genutzt
• Externe Links sind gekennzeichnet
• Abbildungen gut erkennbar
• Alt-Text für Abbildungen, soweit sinnvoll
• Rechtschreibkontrolle durchgeführt
• Zitationen und Literaturverzeichnis(se) korrekt
• Hinweise zu Feedback-/Fragen-/Kontakt-Möglichkeiten

Publikation

• Metadaten sind vollständig
• DOI(s) registriert und in den Metadaten und in der OER
• Vergabe einer Versionsnummer (bspw. v1.0.0) (siehe semver.org)
• Erstellung eines GitHub Releases
• Veröffentlichung in einem Repositorium (bspw. Zenodo)
• Zitationshinweis

Links, Verweise und Abhängigkeit

• Alle nötigen Materialien sind verfügbar. Wenn möglich in einem sicheren Repositorium oder direkt in der OER hinterlegt. Wenn lizenzrechtlich erlaubt Kopie unsicher abgelegter Datensätze anlegen.
• Links innerhalb der Fallstudien funktionieren
• Links auf externe Inhalte überprüft
• Code-Abhängigkeiten sind so definiert, dass sie wieder installiert werden können (requirements.txt, …)
• rechtliche Aspekte (z. B. bei Nachnutzung von existierenden Bildungsangeboten)