# Better documentation with the Diátaxis Framework

Page: https://stenobird.com/podcast/scaling-devtools/better-documentation-with-the-di-taxis-framework
Text version: https://stenobird.com/podcast/scaling-devtools/better-documentation-with-the-di-taxis-framework.md
Podcast: [Scaling DevTools](https://stenobird.com/podcast/scaling-devtools)
Published: 2025-09-19T16:23:36+00:00
Episode link: https://podcast.scalingdevtools.com/episodes/better-documentation-with-the-diataxis-framework
Audio file: https://media.transistor.fm/154a9eaa/7ed38391.mp3
Processing state: failed
JSON: https://stenobird.com/v1/public/podcasts/scaling-devtools/episodes/better-documentation-with-the-di-taxis-framework
Duration seconds: 1464

## Resource

Creating docs that actually work means knowing what to write, how to write it, and where it belongs. In this episode, we break down the diataxis documentation framework—a simple but powerful system that splits docs into four clear types: tutorials, how-to guides, explanations, and reference. We look at examples of tools that have implemented diataxis to write their documentation with clarity and purpose. This episode is brought to you by WorkOS . If you're thinking about selling to enterprise customers, WorkOS can help you add enterprise features like Single Sign On and audit logs. Links: • Diataxis • Sequin • Layercode • Logdy

## Actions

- request_transcript: `POST https://stenobird.com/v1/public/podcasts/scaling-devtools/episodes/better-documentation-with-the-di-taxis-framework/transcription-requests` — Idempotently request low-priority transcript generation for this episode.
- read_markdown: `GET https://stenobird.com/podcast/scaling-devtools/better-documentation-with-the-di-taxis-framework.md` — Read the agent-friendly Markdown representation of this episode resource.

A page view does not enqueue transcription. Agents should invoke `request_transcript` explicitly when they need this episode processed.

## Transcript

Full transcripts are not published on public pages unless there is a clear rights basis.