A technikai dokumentációk jelentős része gyenge minőségű, nagyobb mértékben azért, mert minimális időt és energiát fordítanak a megírásukra; nem a használhatóság, hanem egy kötelező gyakorlat teljesítése a cél. Csakhogy ha azért készül dokumentáció, hogy használják, akkor sem mindig sikerül elfogadható minőségűre, mégpedig gyakran azért nem, mert szem elől tévesztik a célközönséget, illetve az igényeket. Ebben segít a Diataxis keretrendszer, amely négy típusát különbözteti meg a technikai dokumentációnak:
- Oktatóanyag (tutorial): végigvezeti az olvasót egy olyan lépéssorozaton, amellyel megold valamiféle problémát. Tanulásorientált, alapkompetenciák elsajátításához való.
- Útmutató (how-to guide): irányítja az olvasót, milyen lépésekkel oldhat meg egy konkrét gyakorlati problémát. Eredményorientált, egy már kompetens olvasót segít.
- Referencia (reference): felsorolások, listák, táblázatok. Általában megjegyezhetetlen, segédeszköz munkához.
- Magyarázat (explanation): áttekintések, elemzések, tanulmányok. Elméleti tudást ad, tanuláshoz kell.