diataxis-documentation

To separate documentation types, classify each document by user need: tutorials for learning, how-to guides for tasks, references for information, and explanations for understanding. This prevents content blur and aligns docs with specific user goals.

The Diataxis framework structures documentation into tutorials, how-to guides, references, and explanations. It aligns content with user needs by enforcing clear separation of these four types and guiding iterative content improvements.

Restructure a project wiki by selecting an existing document, identifying the user need, and assigning it a Diataxis type. Apply an iterative workflow to assess, decide, and execute small content refinements for better usability.

Connect related documentation types by using cross-referencing recommendations to link tutorials, how-tos, references, and explanations. This maintains strict separation of each document's purpose while ensuring seamless content navigation.

Yes, you can refine technical documentation using an iterative framework of Choose, Assess, Decide, and Do. This workflow guides small, incremental content improvements rather than large, disruptive rewrites.

Avoid a single documentation format when users have distinct needs like learning, task execution, or reference lookup. Merging these purposes creates content blur, making it harder for users to find what they need.