| Diátaxis(diataxis.fr) | |
| 385 points by ryanseys 16 hours ago | 48 comments | |
tl;dr: Diátaxis is a documentation framework that organizes technical writing into four distinct types based on user needs: tutorials, how-to guides, reference, and explanation. It addresses what to write, how to write it, and how to structure it, without imposing heavy implementation constraints. The approach has been adopted by projects at Cloudflare, Gatsby, and others to improve documentation architecture and discoverability. | |
HN Discussion:
| |