ark-documentation

The Diataxis framework structures documentation into four quadrants—Tutorials, How-to Guides, Core Concepts, and Reference—categorizing content by user needs to improve clarity, consistency, and discoverability across Ark hub pages.

To decide where new Ark content belongs, map it to the appropriate Diataxis quadrant based on its purpose: learning-oriented content fits Tutorials, task-oriented fits How-to Guides, information-oriented fits Reference, and understanding-oriented fits Core Concepts.

Yes, you can use the Diataxis guidelines to review documentation pull requests by checking if the submitted content aligns with the correct quadrant, follows Ark terminology rules, and maintains consistent structure across hub pages.

The best way to restructure existing Ark documentation is to audit current content against the Diataxis quadrants, recategorize misplaced articles into Tutorials, How-to Guides, Core Concepts, or Reference, and align them with Ark hub pages.

You need the Ark documentation guidelines when creating new docs, deciding content placement, reviewing pull requests, or restructuring existing documentation to ensure consistent terminology and structure across the four Diataxis quadrants.