Diátaxis

Diátaxis is a systematic approach to technical documentation authoring, focusing on content, architecture, and form. It identifies four distinct needs - tutorials, how-to guides, technical reference, and explanation - and proposes that documentation should be organized around these needs' structures. Diátaxis offers solutions for documentation content, style, and architecture, benefiting both users and creators/maintainers.

It's a lightweight, easy-to-understand methodology that doesn't impose strict implementation constraints. To begin with Diátaxis, one should apply it after reading a primer. The framework has been successfully adopted in numerous documentation projects, helping teams create high-quality, user-friendly documentation. Multiple organizations have reported improved documentation clarity and user experience after implementing Diátaxis, such as Vonage, Gatsby, and Cloudflare.