{"id":36,"slug":"diataxis-framework-procida","title":"Diátaxis (Daniele Procida): four documentation types — tutorials, how-to, reference, explanation","kind":"reference","scope":"business","status":"current","audiences":["claude-code","candid-team"],"topics":["content-architecture","knowledge-base"],"reference_body":"**Claim:** The Diátaxis framework, created by Daniele Procida and published at <https://diataxis.fr>, divides documentation into four user needs:\n\n- **Tutorials** — learning-oriented (guided steps to learn by doing)\n- **How-to guides** — task-oriented (recipes for specific goals)\n- **Reference** — information-oriented (descriptions of the machinery)\n- **Explanation** — understanding-oriented (background and why)\n\nAdopted as the information-architecture backbone of Gatsby and Cloudflare developer documentation.\n\n**Quote (diataxis.fr):** *\"Documentation should be organised around the structures of users' needs.\"*\n\n**Source:** <https://diataxis.fr>\n\n**Confidence:** Verified.\n\n**For Candid use:** Diátaxis maps cleanly onto a marketing site: case studies are tutorials, service pages are how-tos, glossary / pricing / specs are reference, opinion pieces are explanation. Using Diátaxis as the IA of the agency site is recommendation #5 from the brief 3 writer.","rationale_body":null,"metadata":null,"links":{"outgoing":[],"incoming":[{"slug":"matuschak-evergreen-notes","title":"Andy Matuschak: evergreen notes — atomic, concept-oriented, densely linked, accreting over time","kind":"reference","scope":"business","link_type":"relates-to"},{"slug":"stripe-docs-as-product","title":"Stripe docs as a first-class product — Markdoc framework, documentation in performance reviews","kind":"reference","scope":"business","link_type":"relates-to"},{"slug":"research-brief-kb-backed-website-methodology","title":"Research brief: The knowledge-base-backed website (piece 3 of 15)","kind":"reference","scope":"business","link_type":"relates-to"},{"slug":"research-first-named-practitioners-2026","title":"Reference: 8 named exemplars of research-first/docs-as-product methodology — Stripe, Twilio, Anthropic, Gwern, Matuschak, Appleton, BAM, Construction Physics","kind":"reference","scope":"business","link_type":"relates-to"},{"slug":"rule-research-first-sequence-foundation-before-article","title":"RULE: Foundation research before article, article before marketing page. Never write the marketing page first.","kind":"rule","scope":"business","link_type":"depends-on"}]},"created_at":"2026-05-22T18:57:39.618Z","updated_at":"2026-05-22T18:57:39.618Z"}