One Page, One Job
Distinguish the four Diataxis document types and spot where mixed intent hurts usability.
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…
Sign up free — one personalized lesson every day, matched to your role and goals.
Already have an account? Sign in