---
name: documentation-site-expert
description: "Expert guide for technical documentation sites (Mintlify, Docusaurus, Storybook, VitePress) and component documentation / Panduan ahli situs dokumentasi teknis (Mintlify, Docusaurus, Storybook, VitePress) dan dokumentasi komponen."
author: "Roedy Rustam"
---

# Documentation Site Expert (2026 Edition)

[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)

---

<a name="english"></a>
## English

### Orchestration & Integration
- **`openapi-swagger-codegen-expert`**: Auto-generated API documentation.
- **`design-system-architect`**: Component documentation with Storybook.
- **`astro-framework-expert`**: Astro Starlight for docs sites.
- **`seo`**: Documentation site SEO and discoverability.

### Description
Expert guide for building technical documentation sites and component libraries. Covers Mintlify (AI-native docs), Docusaurus 3 (React-powered), Storybook 8 (component playground), VitePress (Vue-powered), Astro Starlight (Astro-powered), and MDX authoring. Includes API reference generation, versioning, search integration, and interactive code playgrounds.

### Trigger Conditions
- Creating documentation sites for APIs, libraries, or products.
- Setting up Storybook for component documentation.
- Choosing a documentation framework.
- Generating API reference docs from OpenAPI specs.

---

### Framework Selection

| Framework | Stack | Search | Versioning | Best For |
|-----------|-------|--------|------------|----------|
| Mintlify | React/MDX | ✅ Built-in AI | ✅ | SaaS API docs |
| Docusaurus 3 | React/MDX | ✅ Algolia | ✅ | OSS project docs |
| Storybook 8 | Any framework | ❌ | ❌ | Component docs/playground |
| VitePress | Vue/Markdown | ✅ Built-in | ❌ | Vue ecosystem docs |
| Starlight | Astro/MDX | ✅ Pagefind | ✅ | Content-heavy docs |

**Recommendation:** Use **Mintlify** for SaaS API docs. Use **Docusaurus** for open-source projects. Use **Storybook** for component libraries.

## Orchestration & Integration
- `openapi-swagger-codegen-expert`, `design-system-architect`, `seo`

---

<a name="bahasa-indonesia"></a>
## Bahasa Indonesia

### Deskripsi
Panduan ahli untuk membangun situs dokumentasi teknis dan library komponen. Mencakup Mintlify, Docusaurus 3, Storybook 8, VitePress, dan Astro Starlight.

### Kondisi Pemicu
- Membuat situs dokumentasi untuk API, library, atau produk.
- Menyiapkan Storybook untuk dokumentasi komponen.
- Memilih framework dokumentasi.
