diataxis:plan

To plan documentation using the Diátaxis model, classify mixed content requests into Tutorial, How-to, Reference, and Explanation quadrants. This approach separates learning-oriented material from practical guides and technical references to address distinct reader needs.

Organizing documentation for multiple audiences requires proposing a structured docs map and a practical writing plan. By mapping content to specific audience needs and applying Diátaxis quadrants, you can generate an execution order that prioritizes deliverables effectively.

Create a writing plan for a full documentation architecture by first conducting source inventories and classifying requests into Diátaxis quadrants. This yields a practical writing plan with a clear execution order for delivering structured documentation.

You need to write tutorials when the goal is learning-oriented guidance, and how-to guides when the reader needs practical steps to achieve a specific task. Classifying content into these distinct Diátaxis quadrants clarifies documentation purpose and structure.

Yes, you can use Diátaxis to plan a README rewrite. It guides documentation projects of varying scopes, from simple README rewrites to full documentation architectures, by classifying ambiguous content and proposing a structured docs map.

Classify ambiguous documentation requests by evaluating reader needs and sorting the content into Tutorial, How-to, Reference, and Explanation quadrants. This Diátaxis-driven classification determines the appropriate documentation type and proposes a structured approach.