The first prompt is not "write the doc." The first prompt is "what kind of doc is this?" Four shapes, four jobs Diataxis separates documentation by user need. A tutorial builds skill, a how-to gets a task done, reference supports lookup, and explanation builds understanding. That distinction matters more with AI because a language model will happily combine all four if you let it. The result feels comprehensive but behaves badly: beginners drown in API tables, operators skim past theory, and reviewers disagree because they are reviewing different implied documents. Why this works A clear type narrows the model and…
Read the full lesson
Sign up free: one personalized lesson every day, matched to your role and goals.
Already have an account? Sign in