| Diátaxis(diataxis.fr) | |
| 549 points by ryanseys 45 days ago | 60 comments | |
tl;dr: Diátaxis is a documentation framework that organizes content 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, and has been adopted by projects like Cloudflare, Gatsby, and Vonage to improve documentation clarity for both readers and contributors. | |
HN Discussion:
| |