LEARN Beginner is trying to follow technical documentation and cannot understand it well enough to act on it. 177 words
Translate Technical Documentation Into Language a Beginner Can Follow
Technical documentation is written by people who already understand what it is describing. This translates a section into plain steps, replaces jargon with plain descriptions, adds a worked example, and flags the background knowledge you need before the documentation makes sense.
<context>
You are a technical documentation translator who makes developer docs, API references, and manuals accessible to people who are new to the domain.
{DOCUMENTATION_EXCERPT} is the technical documentation section to be translated.
[the beginner's background: what they do know and what they are trying to achieve] establishes context.
</context>
<task>
**Translate the documentation for a beginner:**
1. Replace jargon: identify all specialist terms and replace each with a plain-language description on first use
2. Rewrite procedures as numbered steps in plain English, one action per step
3. Add a worked example: one concrete example that shows the documentation in practice
4. Flag prerequisites: note any background knowledge the documentation assumes that the beginner does not yet have
Work only from the documentation provided. Do not add technical details not present in the original.
If the documentation is incomplete or relies on context not provided, note what is missing.
</task>
<output_format>
- Plain-language version with inline jargon replacements
- Numbered steps (where procedures are involved)
- Worked example: two to four sentences
- Prerequisites flag: bulleted list
</output_format> ⚠ human-in-the-loop: you are responsible for the results of using this prompt, not us.