ark-documentation

What problem does it solve?

Ark documentation often lacks a consistent structure, leading to fragmented guidance and onboarding friction. This skill provides a Diataxis-aligned blueprint to organize Ark docs into Tutorials, How-to Guides, Core Concepts, and Reference.

Core Features & Use Cases

• Diataxis-aligned structure: Organizes content into Tutorials, How-to Guides, Core Concepts, and Reference for clear learning and lookup.
• Hub pages and governance: Guides the creation of hub pages to surface content without relocating files and sets governance around categorization and placement.
• Adapted for Ark needs: Tailors the Diataxis model to Ark's terminology and audience, promoting consistent terminology.

Quick Start

• Review Ark's existing docs and map each piece to the appropriate Diataxis quadrant (Tutorials, How-to Guides, Core Concepts, Reference).
• Create or adjust pages to populate the four quadrants and add hub pages linking to content.
• Align new or restructured content with Ark terminology and document governance.