bmad-os-diataxis-style-fix

To fix markdown documentation for Diataxis framework compliance, apply automated style corrections to files in your docs directory, categorizing content into Tutorials, How-to guides, Explanations, and References while enforcing formatting conventions.

The Diataxis framework is a documentation style approach that organizes content into four distinct categories: Tutorials, How-to guides, Explanations, and References, ensuring clarity and structural consistency across markdown files.

To enforce a style guide on markdown files, apply targeted edits across all files within the docs directory to resolve formatting issues like incorrect headers, excessive admonitions, and long list items, generating a summary of all changes.

Yes, you can automatically correct documentation formatting issues before a release by applying style guide rules to markdown files, ensuring adherence to content categorization and formatting conventions, and outputting a complete summary of changes.

Common markdown formatting issues in documentation style guides include incorrect headers, excessive admonitions, and long list items, which can be fixed by applying targeted edits to ensure structural guideline adherence.