Diátaxis
Points and comments are a snapshot, not live.
Diátaxis is a systematic approach to technical documentation organized into four distinct types.
Diátaxis identifies four documentation forms based on user needs: tutorials, how-to guides, technical reference, and explanation. It provides guidance on content, style, and architecture. The framework is lightweight and imposes no implementation constraints. Adopted by companies including Vonage, Gatsby, and Cloudflare, it aims to help creators and maintainers produce clearer documentation.
What commenters are saying
Commenters largely praised Diátaxis for structuring documentation, especially with LLMs for first-pass drafts. Some noted its similarity to Divio's older system. A few criticized it for hiding API docs under 'reference,' requiring extra clicks. Others valued it for splitting tutorials (learning) from how-to guides (real-world tasks). The author responded to criticism about complex hierarchies, indicating improvements are in progress.