classify-diataxis

You classify documentation pages into Diátaxis categories using automated scripts that determine if a page is a tutorial, how-to-guide, reference, or explanation. This ensures consistent content categorization and easy navigation.

The Diátaxis framework is used to categorize documentation into tutorials, how-to-guides, references, and explanations. Automated classification applies predefined criteria to identify page types, streamlining content organization and improving user experience.

Detecting mixed content types involves flagging pages that blend multiple Diátaxis categories for further review. This identification process prevents ambiguous documentation structures and maintains strict framework compliance.

Batch classifying documentation pages is supported by running scripts against a directory of files. This workflow automation processes multiple pages programmatically, streamlining the categorization process for content updates or reviews.

Automated Diátaxis classification works with standard markdown files by applying predefined criteria to the content. The scripts evaluate the document structure and text to accurately identify the appropriate Diátaxis type.

Flagging a page that mixes multiple Diátaxis types highlights ambiguous content that fails to fit a single category. This detection ensures documentation purity by sending mixed pages for review to maintain clear content boundaries.