Dokumentations-Bereinigung - Zusammenfassung

Datum: 11. Januar 2026
Ziel: Dokumentation aufräumen, aktualisieren und konsolidieren nach intensiver Entwicklungsphase

✅ Durchgeführte Änderungen

1. CSS-Variablen aktualisiert

Problem: DESIGN_SYSTEM.md und ADR-CSS-REFACTOR.md zeigten veraltete Farbwerte

Änderungen:

• --color-text: #333333 → #111111 (aktuell)
• --color-text-muted: #666666 → #444444 (aktuell)
• Fehlende Token ergänzt: --color-primary-stronger, --color-surface-soft

Betroffene Dateien:

• ✅ DESIGN_SYSTEM.md
• ✅ ADR-CSS-REFACTOR.md

2. Redundante Test-Dokumentation entfernt

Problem: 3 Dateien zum gleichen Thema (Testing) im Root

Aktion:

• ❌ TESTING_README.md - gelöscht (war nur Verweis auf tests/TESTING.md)
• ❌ TESTING_STRUCTURE.md - gelöscht (Details bereits in tests/TESTING.md)
• ✅ TESTING.md - behalten (kurzer Verweis auf tests/TESTING.md)

Ergebnis: Nur noch 1 Root-Datei als Redirect, Hauptdokumentation in tests/TESTING.md

3. Historische Dokumente archiviert

Problem: Obsolete und zu detaillierte Dokumentation im Root

Aktion: Dateien nach docs/archive/ verschoben:

Neu: docs/archive/README.md - Erklärt Archiv-Zweck und verweist auf aktuelle Dokumentation

4. README.md verbessert

Änderungen:

• TODO-Abschnitte entfernt und mit konkreten Inhalten gefüllt
• Links zu relevanten Dokumentationen hinzugefügt:
  • VERANSTALTUNGEN_ANLEITUNG.md (für Redakteure)
  • DESIGN_SYSTEM.md (Design Tokens)
  • ADR-CSS-REFACTOR.md (Architecture Decisions)
  • VERANSTALTUNGEN_TECHNIK.md (Technische Details)
• CMS-Links und CI/CD-Status-Links eingefügt

Ergebnis: README ist nun vollständig und einsatzbereit

5. Neue Dokumentations-Übersicht erstellt

Neu: DOCUMENTATION.md

Inhalt:

• Strukturierter Überblick aller Dokumentationen
• Kategorisiert nach Zielgruppe (Redakteure vs. Entwickler)
• Wichtigkeits-Rating (⭐⭐⭐ = Pflicht)
• Schnellstart-Guide für neue Entwickler
• Hinweise zu Event-Type-Änderungen (3-Datei-Synchronisation)
• Dokumentations-Philosophie (Was gehört wohin?)

Vorteil: Neueinstieger finden schnell die richtige Dokumentation

📊 Vorher/Nachher Vergleich

Vorher (Probleme)

• ❌ 3 Testing-Dokumentationen im Root (redundant)
• ❌ 4 historische/obsolete Dateien im Root (unübersichtlich)
• ❌ Veraltete CSS-Variablen in Dokumentation
• ❌ README mit TODO-Abschnitten (unvollständig)
• ❌ Keine zentrale Übersicht über Dokumentationen

Nachher (Lösung)

• ✅ 1 Testing-Dokumentation im Root (Redirect)
• ✅ Historische Dateien archiviert mit Erklärung
• ✅ Aktuelle CSS-Variablen in allen Docs
• ✅ README vollständig mit Links
• ✅ DOCUMENTATION.md als zentrale Übersicht

📁 Aktuelle Dokumentations-Struktur

/
├── README.md                           # Haupteinstieg (Installation, Workflows)
├── DOCUMENTATION.md                    # Neue zentrale Übersicht
├── TESTING.md                          # Redirect → tests/TESTING.md
├── DESIGN_SYSTEM.md                    # Token System & Styling
├── ADR-CSS-REFACTOR.md                 # Architecture Decision Record
├── VERANSTALTUNGEN_ANLEITUNG.md        # Anleitung für Redakteure
├── VERANSTALTUNGEN_TECHNIK.md          # Technische Details Events
├── tests/
│   └── TESTING.md                      # Hauptdokumentation Testing & Linting
├── docs/
│   ├── NAME_ASYMMETRY.md               # Event-Type Namen-Konvention
│   └── archive/
│       ├── README.md                   # Archiv-Erklärung (neu)
│       ├── PLAN_COMPLETED.md           # Historisch
│       ├── CREATED_TESTING.md          # Historisch
│       ├── anforderungen.md            # Historisch
│       └── decap-copilot-prompt.md     # Intern
└── .github/
    └── copilot-instructions.md         # GitHub Copilot Instruktionen (aktuell)

🎯 Nächste Schritte (Optional)

Für die Zukunft

1. Bei neuen Features: Dokumentation parallel zur Implementierung erstellen
2. Monatlicher Check: Ist Dokumentation noch aktuell?
3. Neue historische Dokumente: Nach docs/archive/YYYY/ sortieren

Wartung

• DOCUMENTATION.md aktualisieren bei neuen Hauptdokumentationen
• Alte Dokumente zeitnah archivieren (nicht im Root liegen lassen)
• CSS-Variablen-Änderungen in allen 3 Dateien prüfen:
  • DESIGN_SYSTEM.md
  • ADR-CSS-REFACTOR.md
  • assets/css/events.css (Source of Truth)

✅ Ergebnis

Die Dokumentation ist nun:

• ✅ Aktuell - Keine veralteten Inhalte
• ✅ Strukturiert - Klare Kategorisierung nach Zielgruppe
• ✅ Übersichtlich - Zentrale Übersicht in DOCUMENTATION.md
• ✅ Wartbar - Archiv für historische Dokumente
• ✅ Vollständig - Keine TODO-Abschnitte mehr

Stand: 11. Januar 2026
Review empfohlen: In 3 Monaten (April 2026)