Einen lernOS Leitfaden erstellen
Ein lernOS Leitfaden hilft Lernenden, in einem 13-wöchigen Learning Sprint alleine, im Lerntandem oder im Learning Circle (4-5 Personen) neue Kompetenzen aufzubauen. Der Aufwand sollte maximal 2 Stunden pro Woche betragen.
Alle Leitfäden stehen unter der offenen Lizenz CC BY 4.0 und werden als Markdown-Dateien auf GitHub verwaltet.
Was macht einen guten Leitfaden aus?
Ein lernOS Leitfaden hat immer drei Bereiche:
- Grundlagen - theoretischer Hintergrund zum Thema, kompakt und gut verlinkt
- Lernpfad - mindestens 11 Übungen (Katas), je 30-60 Minuten, maximal 2 Seiten pro Kata
- Anhang - Danksagungen, Änderungshistorie, optionales Glossar
Das Lernziel kann aus einer oder einer Kombination dieser drei Ebenen kommen:
- Mindset - eine Haltung entwickeln
- Skillset - eine Fähigkeit erlernen
- Toolset - ein Tool oder eine Methode beherrschen
Wie startest du?
-
Idee konkretisieren
Wer ist die Zielgruppe? Was sollen Lernende nach 13 Wochen können? Gibt es bereits ähnliche Leitfäden?
Melde dich im Discord und stell deine Idee vor.
-
Vorlage herunterladen
Das lernOS Template Repository enthält alle Vorlagen und Beispiele. Lade es als ZIP herunter und entpacke es lokal.
-
Inhalte schreiben
Texte können zunächst in Word oder Google Docs entstehen. Das Quellformat für lernOS Leitfäden ist Markdown - die Konvertierung kommt am Ende.
Empfohlener Editor: MarkText oder Visual Studio Code
-
Produktionskette einrichten
Aus den Markdown-Quellen werden automatisch PDF, Word, HTML und E-Book generiert. Die Produktionskette läuft lokal oder über GitHub Actions in der Cloud.
Lebenszyklus eines lernOS Leitfadens
Ein Leitfaden durchläuft typischerweise diese Phasen:
flowchart LR
A[Idee] --> B[Zieldefinition]
B --> C[Erstellung]
C --> D[Veröffentlichung\n0.x]
D --> E[Praxistest mit 5+ Learning Circle]
E --> F[Stabile Version\n1.0]
F --> G[Pflege]
G --> F
G --> H[Archivierung]Solange ein Leitfaden noch nicht in der Praxis getestet wurde, empfehlen wir die Versionsnummer 0.x. Nach einem erfolgreichen Praxistest erhält er die Version 1.0. Idealerweise erscheint der Leitfaden dann in Deutsch und Englisch.
Technische Produktionskette
Du musst kein Entwickler sein
Die Texterstellung kann in Word oder Google Docs beginnen. Die technische Konvertierung in Markdown und die Einrichtung der Produktionskette kann im Team aufgeteilt werden - nicht alle müssen alles können. Wir empfehlen aber frühzeitig den Leitfaden in Markdown anzulegen und sich damit zu beschäftigen, um Mehraufwand am Ende zu vermeiden.
Die Produktionskette verwendet folgende Tools:
- Markdown als Quellformat für die Texterstellung (Empfohlener Editor: MarkText)
- GitHub zur Versionsverwaltung und Veröffentlichung (Github Desktop für lokales Arbeiten)
- Pandoc zur Konvertierung in PDF, Word, HTML, E-Book
- mkdocs zur Erstellung der Webversion
- mkdocs material als Theme der Webversion
- GitHub Actions für die automatische Generierung in der Cloud
Eine detaillierte Anleitung findest du im lernOS Template Leitfaden.
Fragen und Unterstützung
- Discord
#lernos- schnelle Fragen und Abstimmung