Diátaxis: A Systematic Framework for Technical Documentation
Original: Diátaxis
Why This Matters
Diátaxis offers a scalable, proven standard for documentation quality across open-source and enterprise projects.
Diátaxis is an open framework for technical documentation that identifies four user needs—tutorials, how-to guides, reference, and explanation—and organizes content architecture around those structures. Adopted by Vonage, Gatsby, and Cloudflare, among others.
Diátaxis, derived from the Ancient Greek words for 'across' and 'arrangement,' is a framework created by Daniele Procida that provides a systematic approach to writing and organizing technical documentation. The framework defines four distinct documentation types corresponding to four user needs: tutorials (learning-oriented), how-to guides (task-oriented), technical reference (information-oriented), and explanation (understanding-oriented). Each type has its own prescribed content style and structure.
The framework addresses three core documentation challenges: what to write (content), how to write it (style), and how to organize it (architecture). Designed to be lightweight and implementation-agnostic, Diátaxis has been adopted across hundreds of documentation projects. Cloudflare used it as a 'north star' when redesigning its developer docs. Gatsby applied it to restructure open-source documentation, improving content discoverability. Vonage credits it with helping build internal docs that both users and contributors value. The framework is freely available at diataxis.fr and supports community translation efforts.