3.4 KiB
Schreibe Sections für einen Lern-Guide zum Thema "{topic}" (Format: {format_name}).
Dir zugeteilt sind folgende Kapitel und Bausteine — verbindlich: jede zugeteilte Section muss vorkommen, keine zusätzlichen erfinden. Unter jedem Baustein stehen seine SUBBAUSTEINE mit Stufe ([einfach]/[mittel]/[schwer]):
{zuteilung}
{facts}
Das Format ({format_name}) beeinflusst NICHT, wie ein Baustein geschrieben wird — nur, wie viele Bausteine das Thema abdecken. Derselbe Baustein bekommt in MiniGuide, Guide und FullGuide denselben Text.
Jeder Baustein bekommt ZWEI Fassungen mit DENSELBEN Inhalten (dieselben Subbausteine):
- kompakt: je Subbaustein EIN Merksatz als Stichpunkt (
- …). Zum Erinnern. Nur benennen, nicht erklären. Gleiche Reihenfolge wie ausführlich. - ausführlich: der zusammenhängende Anfänger-Lerntext (siehe unten). Beide MÜSSEN dieselben Subbausteine abdecken. Nichts, das nur in einer Fassung steht.
SO SCHREIBST DU die ausführliche Fassung — EIN zusammenhängender Text für einen Junior, der das Thema NEU lernt:
- Beginne mit dem Anker (Einordnung): welches Problem/wozu, angeknüpft an etwas Bekanntes — erst dann das Neue. Pflicht, nie weglassen.
- Löse JEDEN Fachbegriff bei Erstnennung in einem Halbsatz auf. Setze nichts voraus — auch keine Begriffe aus dem Titel oder anderen Bausteinen. Nutze die „Voraussetzung"-Hinweise aus den Inhalten als Anker, die „Hürde"-Hinweise, um Missverständnisse vorweg auszuräumen.
- Die Subbausteine sind deine INHALTS-CHECKLISTE, keine Überschriften: webe sie in den Fließtext ein. Behandle jeden, aber als Teil eines Ganzen — nicht als isolierten Mini-Absatz.
- Reihenfolge: erst die
[einfach]-Punkte (das Fundament), dann[mittel](Details/Varianten), zuletzt[schwer](Sonderfälle/Tücken — knapp, als fortgeschrittener Hinweis). - Diese Fassung trägt die volle Tiefe selbst — es gibt keine zweite Ausbaustufe. „Wie"-Abläufe Schritt für Schritt zeigen, nicht nur das Ergebnis.
- KEIN festes Längen-Limit. So lang wie nötig, damit ein Neuling es OHNE Vorwissen versteht. Im Zweifel ein Satz mehr und klar.
- Beispiele großzügig — auch kleine Mini-Beispiele mitten im Text, wo sie einen Punkt sofort greifbar machen, zusätzlich zum
### Beispielam Ende (Format laut Spezifikation).
GEPRÜFTE INHALTE je Baustein — das ist verbindlich, was gelehrt werden muss: {inhalte}
Nutze diese Inhalte. Erfinde nichts dazu, lass nichts Wesentliches weg. Lehre simpel: kurze Sätze, Listen für Aufzählungen, ein Anfänger versteht es sofort.
SECTION-SPEZIFIKATION (gilt je Baustein): {spec}
Schreibe NUR die Datei {out_path} in GENAU diesem Format — pro Kapitel ein kapitel-Marker, pro Baustein ein section-Marker (Titel EXAKT aus der Zuteilung), darin ein kompakt- und ein ausführlich-Block:
- Merksatz je Subbaustein (knapp, ohne Erklärung)
Erklärung (Einordnung → Wie/Warum) laut SECTION-SPEZIFIKATION…
Beispiel
(Beispiel im themengerechten Format laut SECTION-SPEZIFIKATION: Codeblock NUR bei Code-Themen, sonst Beispielsätze oder Mini-Szenario)
Die Marker-Zeilen exakt so schreiben (jede Section hat genau einen <!-- kompakt -->- und einen <!-- ausführlich -->-Block). Kein Text außerhalb der Sections, kein Dokument-Titel, kein Inhaltsverzeichnis.
{extra}