Research page template

When to use

• Shelf: learn/research/<topic>/
• kind: research or synthesis note
• Diátaxis mode: explanation / synthesis (not a tutorial)
• Readers served: future-you and agents needing evidence-backed decisions

Design rationale

• Research pages answer a question — lead with the question, not background fluff (Good Docs research patterns).
• Method + sources section — reproducibility for agents and humans (Diátaxis — document your evidence trail).
• Findings before implications — separate observation from recommendation to avoid cherry-picking (evidence-based writing).
• ## Sources mandatory on research pages — both this template file and pages authored from it should end with citations when claims are external.

Copy-paste skeleton

---
title: "<Research question>"
description: One sentence — what we investigated and the headline answer.
kind: research
status: draft
tags: [research, topic]
---

## Question

&lt;Single clear research question.&gt;

## Method

&lt;What we searched, read, or compared — 3–5 bullets.&gt;

## Findings

&lt;Neutral observations — tables welcome.&gt;

## Implications for ZajLibrary

&lt;What we should do differently — links to playbooks/guides.&gt;

## Sources

- [Title](url) — what it contributed

Anti-patterns

• Do not paste vendor dumps verbatim — synthesize (see repo-root AGENTS.md inbox policy).
• Do not ship research without Sources when citing external claims.

Worked example

• Research hub (stub)

Sources

• Diátaxis — Explanation — research synthesizes understanding, not procedures.
• Good Docs Project — structured doc types including research-oriented templates.
• Google developer documentation style guide — separate findings from recommendations.
• Writing style → Doc-type spines