diataxislisted

# Diátaxis Documentation Framework This skill provides comprehensive knowledge about the Diátaxis framework for organizing and writing technical documentation. ## Overview Diátaxis identifies four distinct documentation types, each serving different user needs: | Type | Orientation | Purpose | User Need | |------|-------------|---------|-----------| | **Tutorials** | Learning | Teach through doing | "I want to learn" | | **How-to Guides** | Task | Solve specific problems | "I want to accomplish X" | | **Reference** | Information | Describe the machinery | "I need to know Y" | | **Explanation** | Understanding | Clarify concepts | "I want to understand Z" | ## The Four Quadrants ### Tutorials (Learning-Oriented) - **Purpose**: Help beginners learn by doing - **Approach**: Step-by-step lessons with guaranteed outcomes - **Focus**: The learner's experience - **Goal**: Build confidence and basic competence ### How-to Guides (Task-Oriented) - **Purpose**: Help practitioners accomplish specific tasks - **Approach**: Direct, practical instructions - **Focus**: The problem to solve - **Goal**: Successfully complete a task ### Reference (Information-Oriented) - **Purpose**: Describe the system accurately - **Approach**: Technical, austere, consistent - **Focus**: The machinery itself - **Goal**: Provide accurate information quickly ### Explanation (Understanding-Oriented) - **Purpose**: Illuminate concepts and context - **Approach**: Discursive, reflective - **Focus**: Unders