documentation-writer

Diátaxis documentation is a framework that structures technical content into four distinct types: tutorials, how-tos, references, and explanations. This approach separates learning-oriented material from practical guidance and reference data to improve user comprehension.

To write technical documentation across these formats, define your target audience and project goals first, then outline a four-quadrant documentation plan to generate structured drafts with consistent voice, frontmatter metadata, and aligned terminology.

Yes, the Diátaxis framework supports API reference documentation by separating practical how-to guides and reference sections from conceptual explanations, ensuring technical writers and developers produce consistent, user-centered API content.

The best way to plan a documentation strategy is to clarify your audience and goals, then map content across the four Diátaxis quadrants to ensure comprehensive coverage of tutorials, how-tos, references, and explanations with a practical structure.

Yes, aligning with the project's existing tone and terminology is required to ensure the generated tutorials, how-tos, reference sections, and explanations maintain a consistent voice across all four documentation types.