65 lines
3.2 KiB
Markdown
65 lines
3.2 KiB
Markdown
# Refactor-Status · `refactor/didaktik-rewrite-2026`
|
||
|
||
Letzter Stand: 2026-05-14
|
||
|
||
## Was steht
|
||
|
||
### Foundation (Phasen 0–1)
|
||
- [x] `CLAUDE.md` · `README.md` · `AGENTS.md` mit didaktischem Fundament (auf `main`)
|
||
- [x] `docs/klausur-themen-2026.md` — 9 Klausur-Blöcke für 223015b gelockt (D1–D4 entschieden)
|
||
- [x] `docs/223015b-lernziele.md` — 33 operative Lernziele im Fließsatz-Eichmaß
|
||
- [x] `docs/223015b/01-…-bogen.md` bis `05-…-bogen.md` — 5 Kapitel-Skelette mit Folien-Plan, Streichungs-Liste, Demo-TODO
|
||
|
||
### Demos (Phase 3)
|
||
- [x] `kap02-eroeffner.png` — Lossless vs Lossy Wellenform-Vergleich (FLAC vs MP3 128)
|
||
- [x] `kap03-eroeffner.png` — Drei Modalitäten Datei-Größen-Tabelle (Bild/Audio/Video)
|
||
- [ ] **Kap 4 Eröffner** — Datei-Reise-Pfad (SSD → SATA → USB-C → HDMI → Display mit Datenraten)
|
||
- [ ] **Kap 5 Eröffner** — Foto mit EXIF-Overlay (Privacy-Reveal)
|
||
- [ ] Übrige ~40 unterstützende Demos pro Kapitel (siehe Visualisierungs-Listen in den Bogen-Docs)
|
||
|
||
### Erste 5 Eröffner-Versuche (verworfen)
|
||
Frühere Advance Organizer (`kap01-advance-organizer`, `kap02-bogen`, `kap03-modalitäten-bogen`, `kap04-bogen`, `kap05-bogen`) waren plump, gleichförmig und nicht erkenntnisgewinnend. Per Commit `1c8185b` gelöscht. Begründung: Topic-Boxen mit Pfeilen statt konkrete Daten in Transformation. Neue Strategie: pro Kapitel eigene Konkret-Komposition.
|
||
|
||
### Slides selbst (Phase 4)
|
||
- [ ] Komplett offen — die Bogen-Docs sind das Skelett, daraus werden in Phase 4 die Marp-Markdown-Files erzeugt
|
||
- Reihenfolge laut Plan: 01-fundamentale → 02-kompression → 03-inhalte → 04-speicher → 05-distribution
|
||
- Aktuelle Slide-Files (`01-grundlagen-text-audio.md` etc.) bleiben unangetastet bis die neuen Files stehen — kein „halb migriert"-Zustand
|
||
- Make-Pattern erlaubt es, die alten Files weiterzulaufen während neue gebaut werden (gleicher Build-Befehl)
|
||
|
||
## Wo weitermachen
|
||
|
||
**Empfohlene nächste Schritte (in dieser Reihenfolge):**
|
||
|
||
1. Kap 4 Eröffner-Demo bauen — Datei-Reise-Pfad
|
||
2. Kap 5 Eröffner-Demo bauen — EXIF-Overlay
|
||
3. Pro Kapitel die 3–4 wichtigsten neuen Demos (z.B. JPEG-Pipeline-Stationen, USB-C-drei-Achsen, CDN-Schema)
|
||
4. Phase 4 starten: Slide-MD-Files pro Kapitel schreiben, dabei existierende + neue Demos einbinden
|
||
5. Build-Test (`make build-223015b`), Render-Spot-Check
|
||
6. Erste Dozenten-Lesart durch Kapitel 1+2, justieren
|
||
7. Iterativ Kap 3–5
|
||
8. PR auf `main`, Review, Merge, Deploy
|
||
|
||
## Wichtige Konventionen
|
||
|
||
- **Keine Emojis** — auch nicht als Icons in HTML-Demos
|
||
- **„Bit"/„Byte" sind Maßwörter** — kein s-Plural („Bits"/„Bytes")
|
||
- **„Selbstlernen"**, nicht „Hands-On"
|
||
- **Klausur-Folien bleiben verstreut** — kein Sammelblock am Kapitel-Ende
|
||
- **Lernziele = Vorschläge** an den Dozenten, nicht gesetzte Anforderungen; Default Bloom-Level Verstehen
|
||
- **Render vor Layout-Aussage** — chromium-headless, dann PNG mit Read-Tool inspizieren
|
||
- **Advance Organizer = Erkenntnisgewinn**, nicht Topic-Boxen mit Pfeilen
|
||
|
||
## Branch-Operationen
|
||
|
||
```bash
|
||
# Stand sehen
|
||
git log --oneline refactor/didaktik-rewrite-2026
|
||
|
||
# Auf neuesten Stand bringen
|
||
git switch refactor/didaktik-rewrite-2026
|
||
git pull origin refactor/didaktik-rewrite-2026
|
||
|
||
# Plan-Datei
|
||
cat ~/.claude/plans/1-infinity-2-neue-wild-ember.md
|
||
```
|