Saltar al contenido principal

One Page, One Job

Distinguish the four Diataxis document types and spot where mixed intent hurts usability.

technical-writing5 min read

Readers do not come to documentation with one generic need. They arrive to learn, to complete work, to verify a fact, or to understand why something exists. Diataxis names those needs so you can stop writing every page as a confused hybrid. A page gets easier to use when the writer decides its job before drafting the first sentence. Minimalism then strips away everything that does not help with that job, and docs-as-code keeps the structure visible in navigation, file names, review comments, and PR scope. The four jobs Tutorials teach by guided success. How-to guides help a capable user…

Read the full lesson

Sign up free: one personalized lesson every day, matched to your role and goals.

← Back to library

Contáctanos