documentation-site-expert · diff
git:20260907.57a4b90 to v3.0.0
59 added, 59 removed. Audit A to A.
- ---
- 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.
+ ---
+ 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"
+ version: "3.0.0"
+ ---
+
+ # 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.
-