52 lines
4.3 KiB
Markdown
52 lines
4.3 KiB
Markdown
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):
|
|
|
|
<!-- kapitel: chapter title -->
|
|
<!-- section: exact block title -->
|
|
<!-- compact -->
|
|
<!-- sub: beginner | exact subblock title -->
|
|
- mnemonic for this subblock (concise, no explanation)
|
|
<!-- sub: advanced | exact subblock title -->
|
|
- mnemonic for this subblock
|
|
<!-- ausführlich -->
|
|
Anchor: framing of the whole block (which problem, what for) — before the first subblock.
|
|
<!-- sub: beginner | exact subblock title -->
|
|
Beginner-friendly prose for this subblock, with a small example.
|
|
<!-- sub: advanced | exact subblock title -->
|
|
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}
|