Diataxis at a Glance
Recall the core Diataxis distinctions quickly during drafting and review.
flashcards comparison Tutorial or how-to? Study vs work The difference is not beginner versus advanced. It is study mode versus work mode. Reference or explanation? Fact vs understanding Reference describes what is. Explanation helps the reader understand why it matters. What question exposes a mixed page fastest? What should this reader be able to do or know immediately after this page? If the answer changes mid-page, the page is probably mixing jobs. What is the minimalist test for whether a paragraph belongs? Does this paragraph help the current reader need right now? If not, cut it or move it to…
Sign up free — one personalized lesson every day, matched to your role and goals.
Already have an account? Sign in