Get the latest tech news

Diátaxis – A systematic approach to technical documentation authoring


The Diátaxis framework solves a problem of quality in technical documentation, describing an information architecture that makes it easier to create, maintain and use.

Diátaxis identifies four distinct needs, and four corresponding forms of documentation - tutorials, how-to guides, technical reference and explanation. It brings an active principle of quality to documentation that helps maintainers think effectively about their own work. At Gatsby we recently reorganized our open-source documentation, and the Diátaxis framework was our go-to resource throughout the project.

Get the Android app

Or read this on Hacker News

Read more on:

Photo of systematic approach

systematic approach

Photo of Diátaxis

Diátaxis

Related news:

News photo

A systematic approach to deriving incremental type checkers (2020)

News photo

Pulley system composition – a systematic approach (2020)