# Research doc

> Template for a research doc that is the single source of a factual page - frontmatter, analysis, guidance, mistakes, risks, evidence summary and a review checklist.

For any page that makes factual claims. Adapt section 3 to the domain (for example movement analysis for exercises, specification for products). Rules: [evidence and citation](/web/evidence-and-citation/).

```md title="docs/research/<type>/<slug>.md"
---
slug: <item-slug>
title: <Canonical name>
aliases: [<alias>, <alias>]
version: 0.1.0
status: draft            # draft | reviewed | published | needs-update
author: <name>
reviewer: <name, credential> | none
lastReviewed: YYYY-MM-DD
nextReview: YYYY-MM-DD   # default +12 months; +6 for fast-changing topics
searchTerms: ["<query people type>", ...]
sources: [S0xx, ...]
---

# <Canonical name> — Research Doc

Written for an expert reader (specialist, reviewer, AI agent). The public page is a reader-friendly rendering of this doc. If it isn't in the doc, it isn't on the page.

## 1. Summary (page lede)
Two sentences: what it is, why it matters, why choose it over alternatives.

## 2. Definition and context
Precise definition, scope, related concepts, what it is not.

## 3. Detailed analysis
<Domain-specific core section: mechanism, specification, steps, parameters. Precise enough for someone to build from.>

## 4. Practical guidance
<What the reader should do, step by step. Each step: **cue** + one sentence.>

## 5. Common mistakes
| Mistake | Why it matters | Fix | Evidence / certainty |
|---|---|---|---|

## 6. Who it suits / who should be careful
- Good fit
- Check first / modify (condition → safer option → who to ask)
- Stop signs or red flags

## 7. Risks
What can go wrong, how common (if data exist), how to reduce it. Cite.

## 8. Alternatives and relationships
Siblings, simpler options, advanced options, with one line on when to choose each.

## 9. Evidence summary ("How sure are we")
| Claim | Certainty | Sources | Limitations |
|---|---|---|---|

## 10. Open questions / to verify
Anything uncertain or any source still "To verify". Nothing here is published.

## 11. SEO notes
Primary query, secondary queries, title (≤ 60), description (120–160), internal links.

## 12. Changelog
- 0.1.0 (YYYY-MM-DD): first draft

---

### Review checklist (human, before `status: reviewed`)
- [ ] Every factual sentence has a source ID or is labelled as experience/practice
- [ ] All cited sources are Verified (or Verified via secondary and not the sole basis for High)
- [ ] Certainty labels justified, not inflated
- [ ] Populations / conditions of evidence stated
- [ ] Guidance executable by the target reader
- [ ] Safety wording and referral advice present where relevant
- [ ] No contradictions with related docs
- [ ] No copied text; no fabricated experience
```