Diátaxis is a systematic approach to technical documentation authoring that focuses on understanding the needs of documentation users. It identifies four distinct needs and corresponding forms of documentation – tutorials, how-to guides, technical reference, and explanation. By organizing documentation around these needs, Diátaxis solves content, style, and architecture problems without imposing constraints. It is lightweight, easy to understand, and straightforward to apply. The framework has been successfully adopted in hundreds of documentation projects, including by companies like Gatsby and Cloudflare. By restructuring their documentation using Diátaxis, they were able to prioritize user goals and improve clarity for both readers and contributors.
https://diataxis.fr/