diataxis-writer

# Diataxis Writer Use Diataxis to align documentation with the reader's actual need. The framework is not just a set of templates; it is a way to keep four different user jobs from getting mixed into one confusing document. ## Explaining Diataxis to Users When the user asks what Diataxis is, why it matters, or why this framework is a good fit, explain it briefly before applying it: Diataxis is a documentation framework that separates docs by the reader's mode of work: learning, doing, looking up facts, or understanding concepts. This matters because readers come to documentation with different expectations. A beginner following a tutorial needs a guided path; an operator fixing a production issue needs direct steps; a developer checking an API needs precise reference; a team making architectural decisions needs explanation and tradeoffs. Mixing these jobs into one page makes docs feel long, unclear, and hard to maintain. Use these benefits when recommending Diataxis: - It clarifies what each document is for before writing begins. - It reduces bloated "everything pages" by separating learning, task execution, lookup, and conceptual understanding. - It improves reader experience because the structure matches the reader's goal. - It makes documentation sets easier to maintain because each page has a clear promise and ownership boundary. - It works beyond technical docs for knowledge bases, onboarding material, internal process docs, manuals, and operational guides, a...