nw-divio-framework

The Diataxis four-quadrant framework is a classification system that organizes documentation into Tutorial, How-to Guide, Reference, and Explanation types to standardize content and improve discoverability.

You classify product docs by mapping existing materials to the four quadrants using a decision tree and signal catalog, annotating each piece with its intended purpose to guide authoring workflows.

Use a tutorial for learning-oriented content that guides users through a lesson, and use a how-to guide for task-oriented content that helps users achieve a specific goal.

A documentation decision tree and signal catalog improve discoverability by providing consistent tagging and naming conventions, enabling clearer searchability and standardized organization across all documentation artifacts.

The best way to standardize developer guides and references is applying the DIVIO framework to categorize materials into four distinct types, ensuring each document satisfies a specific classification signal.