ark-documentation

To structure documentation with Diataxis, you categorize content into Introduction, Quickstart, Tutorials, How-to Guides, Core Concepts, and Reference. This skill defines that taxonomy specifically for Ark content to improve discoverability and guide contributors.

Organizing Ark hub pages involves implementing a Diataxis-aligned taxonomy that separates content into Introduction, Quickstart, Tutorials, How-to Guides, Core Concepts, and Reference sections. This structure guides contributors and improves content discoverability.

To decide where new content belongs during PR reviews, map the submission against the Diataxis-based taxonomy. Check whether the content functions as a Tutorial, How-to Guide, Core Concept, or Reference entry to place it in the correct Ark hub page.

You start creating new Ark docs by placing them in the Core Concepts or Tutorials sections. The skill provides writing guidelines and a defined taxonomy to ensure your new documentation integrates consistently with the existing Ark structure.

Restructure existing Ark content when it lacks consistent structure and users struggle to locate guidance. Moving content into the Diataxis-aligned hub pages defined by this skill improves discoverability and aligns the documentation with standard writing guidelines.

Yes, the Diataxis-aligned taxonomy explicitly includes Marketplace and Disclaimer as dedicated hub pages. This ensures that all specific Ark content types, including commercial and legal documentation, are categorized and organized consistently.