ark-documentation

Guide teams to structure Ark documentation using the Diataxis framework.

Updated Aug 23, 2026

Search Tags:#documentation #structure #guidelines #diataxis #ark #hub-pages

Ready to run

npx skills add https://github.com/vishalpatel2890/slides --skill ark-documentation-vishalpatel2890

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ark-documentation
Source: https://github.com/vishalpatel2890/slides/tree/main/.claude/skills/documentation
Command: npx skills add https://github.com/vishalpatel2890/slides --skill ark-documentation-vishalpatel2890

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Ark documentation framework provides a clear, repeatable approach to structuring docs using the Diataxis model, improving consistency and discoverability across Ark content.

Core Features & Use Cases

Guidance for mapping Ark content to the Diataxis quadrants (Tutorials, How-to Guides, Core Concepts, Reference).
Clear terminology and structure guidelines to aid authors, reviewers, and contributors.
Use Cases: creating new docs, deciding content placement, reviewing PRs, and restructuring existing documentation.

Quick Start

Follow the Diataxis-based process to categorize new documentation and align it with Ark's hub pages.

Frequently Asked Questions about ark-documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

What is the Diataxis framework for structuring 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.

How do I decide where new Ark content belongs using Diataxis?▼

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.

Can I use the Diataxis guidelines to review documentation pull requests?▼

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.

What's the best way to restructure existing Ark documentation?▼

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.

When do I need to use the Ark documentation guidelines?▼

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.