diataxis-convertlisted

# Diátaxis Documentation Converter Split mixed documentation into separate, focused documents — one per [Diátaxis](https://diataxis.fr/) quadrant. ## Diátaxis Compass ``` Practical Theoretical +----------------+------------------+ Study | TUTORIALS | EXPLANATION | | (learning) | (understanding) | +----------------+------------------+ Work | HOW-TO | REFERENCE | | (problem) | (information) | +----------------+------------------+ ``` ## When to Use - Documentation exists but mixes multiple quadrants in a single document - A `diataxis-audit` flagged mixed content that needs splitting - A long README or guide tries to be everything at once - Users report difficulty finding information in existing docs ## Required Inputs 1. **Source document(s)**: The mixed documentation to convert 2. **Audit report** (optional): Output from `diataxis-audit` identifying mixed sections 3. **Output directory** (optional): Where to write the separated documents ## Common Patterns The most frequent mixing patterns and how to resolve them: | Pattern | Symptom | Resolution | |---------|---------|------------| | Tutorial + Explanation | Steps interrupted by long "why" sections | Extract explanations, link from tutorial | | How-to + Tutorial | Guide that teaches from scratch | Extract learning path into tutorial, keep problem-solving in how-to | | Reference + How-to | API docs with embedded in