Diataxis
Topics: Documentation
Diátaxis is an approach to quality in technical documentation. It describes an information architecture that emerges from a systematic approach to understanding the needs of documentation users.
Diataxis identifies four modes of documentation:
- Tutorials
- How-to guides
- Technical references
- Explanation
Each of these modes (or types) corresponds to a different user need.
| Serve our study | Serve our work | |
|---|---|---|
| Practical steps | Tutorials | How-to guides |
| Theoretical knowledge | Explanation | Reference |
According to Diataxis, technical documentation should be structured explicitly around these four types, and should keep them separate and distinct from each other. In other words, what we call documentation is fundamentally not one thing, but four.
Subtopics
Bookmarks
- Diátaxis website