51 lines
3.5 KiB
Markdown
51 lines
3.5 KiB
Markdown
Write ONE section of a learning guide on the topic "{topic}" (format: {format_name}) — the block below, nothing else.
|
||
|
||
CHAPTER: {chapter}
|
||
BLOCK with its SUBBLOCKS and level labels (`[beginner]`/`[advanced]`/`[expert]`/`[peripheral]`):
|
||
{assignment}
|
||
|
||
LEARNING OBJECTIVES — after reading, a beginner must be able to do exactly this (a coverage gate checks the text against these objectives):
|
||
{ziele}
|
||
|
||
VERIFIED FACTS per subblock — binding basis. Quote cited facts (FACT[Source]) VERBATIM, invent nothing extra, do NOT re-research (a fact gate checks every claim against this list):
|
||
{facts}
|
||
{examples}
|
||
{gaps}
|
||
IMPORTANT — each subblock is delimited with a marker so the guide can later be shown in stages. The label comes EXACTLY from the assignment. Despite the marker, you write FLUENTLY and interwoven — the marker is an invisible interface, NOT a visible heading.
|
||
|
||
The content is INDEPENDENT of the level: every subblock is explained in a **beginner-friendly** way, no matter the label. The label only says WHEN in the learning path the point comes up (foundation → finesse) — NOT how complicated it is written.
|
||
|
||
The block gets TWO versions with the SAME subblocks (same titles, same order):
|
||
- **compact**: one mnemonic per subblock as a bullet (`- …`). For recall. Only name it, don't explain.
|
||
- **ausführlich** (detailed): the coherent beginner learning text.
|
||
|
||
HOW TO WRITE the detailed version — ONE coherent text for a junior who is learning the topic anew:
|
||
- Start with the anchor (framing): which problem / what for, tied to something familiar — BEFORE the first subblock marker. Mandatory.
|
||
- Resolve EVERY technical term at first mention in half a sentence. Use "Prerequisite" hints as anchors, "Hurdle" hints to clear misconceptions up front.
|
||
- Order of the subblocks as in the assignment: first `[beginner]`, then `[advanced]`, then `[expert]`, last `[peripheral]`.
|
||
- The NUMBER of subblocks is the depth signal: many subblocks → the block deserves length; few → keep it short. Never pad.
|
||
- LENGTH TARGET for the detailed version: about {budget} characters total (guideline, not a hard limit — covering ALL learning objectives always beats brevity). Unguided sections came out 2–4× too long and had to be rewritten.
|
||
- CONCISE: every sentence carries new information. No repetition, no filler, no preamble. When in doubt, leave it out.
|
||
- Show "how" procedures step by step. An example ONLY where it genuinely carries the understanding.
|
||
- If VERIFIED WORKED EXAMPLES are provided above, weave each into its subblock as instructed there; do NOT invent additional worked examples for subblocks that already have one.
|
||
|
||
SECTION SPECIFICATION:
|
||
{spec}
|
||
|
||
Write the entire guide content in GERMAN (the guide is for German-speaking learners), even though these instructions are in English.
|
||
|
||
Write ONLY the file {out_path} in EXACTLY this format — one kapitel marker, one section marker (title EXACTLY as in the assignment), a `compact` and an `ausführlich` block, each subblock with its `<!-- sub: LABEL | subblock title -->` marker (LABEL and title EXACTLY from the assignment, same order in both blocks):
|
||
|
||
<!-- kapitel: {chapter} -->
|
||
<!-- section: exact block title -->
|
||
<!-- compact -->
|
||
<!-- sub: beginner | exact subblock title -->
|
||
- mnemonic for this subblock (concise, no explanation)
|
||
<!-- ausführlich -->
|
||
Anchor: framing of the whole block — before the first subblock.
|
||
<!-- sub: beginner | exact subblock title -->
|
||
Beginner-friendly prose for this subblock.
|
||
|
||
No text outside the section, no document title, no table of contents.
|
||
{extra}
|