29 lines
1.4 KiB
Markdown
29 lines
1.4 KiB
Markdown
Prüfe geschriebene Sections eines Lern-Guides zum Thema "{topic}" (Format: {format_name}) auf Lesbarkeit.
|
|
Zielgruppe: Anfänger.
|
|
|
|
SECTION-SPEZIFIKATION (Soll-Zustand):
|
|
{spec}
|
|
|
|
SECTIONS:
|
|
{sections}
|
|
|
|
Prüfe jede Section:
|
|
1. Lehrt die Section das Konzept für einen Anfänger ohne Vorwissen verständlich — ordnet sie es ein, erklärt sie das Wie/Warum, macht ein Beispiel es konkret? Nicht so verdichtet, dass nur jemand sie versteht, der das Thema schon kennt.
|
|
2. Lesbarkeit (echte Mängel notieren):
|
|
- Sätze über ~25 Wörter oder Schachtelsätze mit mehreren Einschüben.
|
|
- Eine Aufzählung (Schritte/Optionen/Anforderungen) als langer Fließtext-Satz, die eine Markdown-Liste sein sollte.
|
|
- Textwand: ein dichter Block ohne Absätze, der sich in mehrere teilen ließe.
|
|
- Mehr als ~4 neue Fachbegriffe ohne Erklärung beim ersten Auftreten.
|
|
3. Sind die Beispiele kurz, simpel, plausibel korrekt — und im themengerechten Format laut Spezifikation (kein Codeblock um Prosa-Beispiele, kein Prosa-Pseudo-Beispiel, wo Code gefragt ist)?
|
|
4. Ist das Markdown sauber (keine abgebrochenen Code-Blöcke, keine Platzhalter, kein Fremdtext)?
|
|
|
|
Du PRÜFST nur und notierst Probleme — du änderst nichts. Nur echte Mängel notieren, keine Geschmacksfragen.
|
|
|
|
Schreibe NUR die JSON-Datei nach: {out_path}
|
|
|
|
Format — alles in Ordnung:
|
|
{{"ok": true}}
|
|
Sonst (Section-Titel EXAKT wie oben):
|
|
{{"probleme": [{{"section": "Exakter Section-Titel", "problem": "…"}}]}}
|
|
{extra}
|