TECH Signal 307
Diátaxis
For engineers creating or maintaining documentation, this framework provides a structured method to determine content, style, and organization. Teams at Cloudflare and Gatsby have applied these principles to resolve information architecture questions and make their documentation easier for both readers and contributors to navigate.
Written by elseif from the cluster below · every claim links back to a sourceThe three things worth knowing
The framework divides documentation into four quadrants based on user needs: tutorials, how-to guides, technical reference, and explanation.
It addresses documentation challenges related to content creation, writing style, and overall information architecture.
Engineering teams at companies like Vonage, Gatsby, and Cloudflare have applied the framework to successfully reorganize and clarify their documentation.
THE CLUSTER