documentation-writer

Diátaxis framework structures technical writing into four quadrants: tutorials, how-tos, references, and explanations. This documentation approach separates learning goals to maintain clarity and audience focus for developer audiences.

You can create software documentation with frontmatter templates by using structured content workflows that generate Diátaxis-aligned drafts. This process outputs metadata ready for indexing, integrating directly with your site generator for discovery.

Yes, you can use markdown to generate tutorials and how-tos for developer audiences. The skill produces audience-driven content that maintains a consistent voice and clarity across all four Diátaxis documentation types.

The best way to write technical documentation for a new feature is providing a complete, Diátaxis-aligned draft. Using frontmatter conventions and structured templates ensures the content meets criteria for accuracy and consistent structure.

Yes, this documentation workflow supports custom frontmatter for site generator indexing. It outputs frontmatter-driven metadata specifically designed for discovery, ensuring your tutorials and references integrate seamlessly with static site generators.