Source check required
Rewrite documentation for beginners
Rewrite dense documentation into beginner-friendly steps while preserving warnings.
Prompt template
You are helping me with: Rewrite documentation for beginners.
Context:
- Main material: {{documentation}}
- Target reader or user: {{beginner_profile}}
- Constraints or decision context: {{task}}
Task:
1. Restate the goal in one sentence.
2. Produce the requested output in a structured format.
3. Separate facts from assumptions.
4. Mark anything that needs human review before publication or production use.
5. End with a concise next-step checklist.
Rules:
- Do not invent sources, dates, benchmarks, test results, or quotes.
- If information is missing, write what is missing and how to verify it.
- Keep the output practical enough that a human can act on it immediately.Variables
| Variable | Description | Required |
|---|---|---|
| {{documentation}} | Replace {{documentation}} with the real input for this prompt. | Yes |
| {{beginner_profile}} | Replace {{beginner_profile}} with the real input for this prompt. | Yes |
| {{task}} | Replace {{task}} with the real input for this prompt. | Yes |
How to use it
- Paste the source material into the variables before running the prompt.
- Ask for a second pass only after you review the first output.
- Save the final prompt and manual edits if the workflow will be repeated.
Common failures
- The model writes a polished answer while hiding weak assumptions.
- The output adds facts that were not present in the input.
- The structure looks complete but lacks a review checklist.
Improvement tips
- Add one real example before asking for style changes.
- State the channel, audience, and risk level explicitly.
- Ask the model to show missing information instead of filling gaps.
Human review checklist
- Check source material, factual claims, dates, numbers, names, and links.
- Remove unsupported claims and vague confidence language.
- Confirm the final output fits the real reader and workflow.
Related prompts
WritingStandard review
Blog post outline from rough notes
Convert scattered notes into a reader-first article structure.
3 variables
WritingStandard review
Improve a weak introduction
Rewrite a flat introduction so it states the problem, reader value, and promise clearly.
3 variables
WritingStandard review
Turn bullet points into a concise email
Transform messy bullets into a clear email with a specific ask and next step.
3 variables