4.3 KiB
Write sections for a learning guide on the topic "{topic}" (format: {format_name}).
You are assigned the following chapters and blocks — binding: every assigned section must appear, invent no additional ones. Beneath each block are its SUBBLOCKS with their level label ([beginner]/[advanced]/[expert]/[peripheral]):
{assignment}
IMPORTANT — each subblock is delimited with a marker so the guide can later be shown in stages (beginners see only beginner, advanced learners see more). 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. An [expert] point is explained just as simply as a [beginner] point. No perfectionism, no artificial depth: the essentials made clear, so that a newcomer understands them.
Each 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 (see below).
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 — only then the new material. The anchor comes BEFORE the first subblock marker. Mandatory, never omit it.
- Resolve EVERY technical term at first mention in half a sentence. Assume nothing — not even terms from the title or other blocks. Use the "Prerequisite" hints as anchors, and the "Hurdle" hints to clear up misconceptions up front.
- Treat each subblock under its marker — fluently phrased, explanatory prose, not an isolated bullet block.
- Order of the subblocks as in the assignment: first
[beginner](foundation), then[advanced], then[expert], last[peripheral]. - Show "how" procedures step by step, not just the result.
- CONCISE: every sentence carries new information. No repetition, no filler or meta sentences, no preamble. Superfluous material harms learning — when in doubt, leave it out, don't add.
- Length follows the content: a trivial detail one or two sentences; a complex concept as much as it REALLY needs — no more. Not "as long as possible".
- An example ONLY where it genuinely carries the understanding — not dutifully for every subblock.
VERIFIED CONTENTS per block — this is binding, what must be taught: {contents}
Do NOT research and do NOT search the web. All necessary facts are in these verified contents — use only them. Invent nothing, leave out nothing essential. Teach simply: short sentences, lists for enumerations, a beginner understands it at once.
SECTION SPECIFICATION (applies per block): {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 per chapter, one section marker per block (title EXACTLY from the assignment), with a compact and an ausführlich block inside. In BOTH blocks, each subblock carries a <!-- sub: LABEL | subblock title --> marker (LABEL and title EXACTLY from the assignment, same order in both blocks):
- mnemonic for this subblock (concise, no explanation)
- mnemonic for this subblock
Anchor: framing of the whole block (which problem, what for) — before the first subblock.
Beginner-friendly prose for this subblock, with a small example.
Beginner-friendly prose for this subblock.
Write the marker lines exactly like that. Each section has exactly one <!-- compact --> and one <!-- ausführlich --> block; the subblock titles are identical in both. No text outside the sections, no document title, no table of contents.
{extra}