DiscoverScaling DevToolsBetter documentation with the Diátaxis Framework
Better documentation with the Diátaxis Framework

Better documentation with the Diátaxis Framework

Update: 2025-09-19
Share

Description

Creating docs that actually work means knowing what to write, how to write it, and where it belongs. In this episode, we break down the diataxis documentation framework—a simple but powerful system that splits docs into four clear types: tutorials, how-to guides, explanations, and reference. We look at examples of tools that have implemented diataxis to write their documentation with clarity and purpose.

This episode is brought to you by WorkOS. If you're thinking about selling to enterprise customers, WorkOS can help you add enterprise features like Single Sign On and audit logs.

Links:
   •  Diataxis
   •  Sequin
   •  Layercode
   •  Logdy

Comments 
loading
In Channel
loading
00:00
00:00
1.0x

0.5x

0.8x

1.0x

1.25x

1.5x

2.0x

3.0x

Sleep Timer

Off

End of Episode

5 Minutes

10 Minutes

15 Minutes

30 Minutes

45 Minutes

60 Minutes

120 Minutes

Better documentation with the Diátaxis Framework

Better documentation with the Diátaxis Framework

Jack Bridger