Integrating v2 docs to repo

.github/copilot-instructions.md

@@ -0,0 +1,91 @@
+docs. The docs are built and previewed using Mintlify CLI, and can be
+containerized with Docker.
+
+# Copilot Instructions for Livepeer Docs (2026)
+
+## Big Picture & Architecture
+
+- **Multi-version Docs:**
+  - `v1/` = legacy, `v2/` = current. Navigation in `docs.json`/`docs_v2.json`.
+- **Component System:**
+  - Custom React/TSX/JSX components in `snippets/components/` (see
+    README-custom-view.md for advanced usage).
+  - Use `.tsx` for new components; `.jsx` is legacy but supported.
+- **Automations & Scripts:**
+  - All dynamic, AI, and data-fetching logic in `automations/` and `ai-tools/`.
+  - Scripts for API doc generation and external data in `v2/scripts/` (see
+    generate-api-docs.sh, fetch-openapi-specs.sh).
+- **API Reference:**
+  - OpenAPI spec in `openapi.yaml` (AI API: see ai/worker/api/openapi.yaml). Use
+    scripts to generate MDX/API docs.
+- **Assets:**
+  - Images/logos in `images/`, `logo/`, and static assets in `assets/`.
+
+## Developer Workflows
+
+- **Preview Locally:**
+  1. Install Mintlify CLI: `npm i -g mintlify`
+  2. Run: `mint dev` (from repo root, where `mint.json` or `mint_v1.json`
+     exists)
+- **Build/Deploy:**
+  - Docker:
+    `docker buildx build --platform linux/amd64 --load -t livepeer/docs .`
+  - Makefile: `make all`
+- **API Docs Generation:**
+  - Use `v2/scripts/generate-api-docs.sh` to convert OpenAPI specs to MDX/API
+    docs and navigation JSON. Example:
+    ```bash
+    ./v2/scripts/generate-api-docs.sh ai/worker/api/openapi.yaml v2/pages/04_gateways/guides-references/api-reference/AI-API "AI API"
+    ```
+  - Output: MDX files + navigation snippet for `docs.json`.
+- **External Data Fetching:**
+  - Use `fetch-openapi-specs.sh` and `fetch-external-docs.sh` for syncing
+    specs/docs from other repos.
+- **Component Usage:**
+  - Import with relative paths from `snippets/components/` in `.mdx` files.
+  - For custom dropdowns, see `CustomViewDropdown` in
+    `snippets/components/custom-view-dropdown.jsx` and its README.
+
+## Project Conventions & Patterns
+
+- **MDX-First:** All docs are `.mdx` (Markdown + JSX/TSX components).
+- **Versioning:** New docs in `v2/`, legacy in `v1/` or
+  `deprecated-references/`.
+- **AI/Dynamic Content:** All AI-generated or dynamic content in `automations/`
+  or `ai-tools/`.
+- **SEO & Metadata:** Add SEO tags/metadata in page frontmatter (see
+  `README_V2.md`).
+- **No Formal Test Suite:** Preview changes locally before merging.
+- **Architecture:**
+  - Docs mirror protocol architecture: Gateway, Orchestrator, Transcoder, AI
+    Worker. See `README_V2.md` for detailed flows and node roles.
+  - Gateways do not process video; they route jobs to orchestrators. Node roles
+    are mutually exclusive (see `README_V2.md`).
+- **Custom Views:**
+  - Use `CustomViewDropdown` for Mintlify-style view switching. See
+    `snippets/components/README-custom-view.md` for migration and usage.
+
+## Integration Points
+
+- **Mintlify:** All build/preview flows use Mintlify CLI and config files
+  (`mint.json`, `docs.json`).
+- **OpenAPI:** API docs generated from `openapi.yaml` (see also
+  `ai/worker/api/openapi.yaml`).
+- **Docker:** Containerized builds for CI/CD and local dev.
+- **Automations:** Scripts in `v2/scripts/` automate API doc generation and
+  external data sync.
+
+## Key Files & Directories
+
+- `docs.json`, `docs_v2.json` — Navigation/config
+- `snippets/components/` — Custom components (see README-custom-view.md)
+- `automations/`, `ai-tools/` — Scripts, AI, dynamic content
+- `openapi.yaml`, `ai/worker/api/openapi.yaml` — API reference
+- `Dockerfile`, `Makefile` — Build/deploy
+- `README.md`, `README_V2.md` — Developer notes, protocol/architecture
+- `v2/scripts/` — Automation scripts (API docs, data fetching)
+
+---
+
+If any conventions or workflows are unclear, review the latest `README.md`,
+`README_V2.md`, or automation READMEs, or ask for clarification.

.github/workflows/broken-links.yml

@@ -16,8 +16,8 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
-        
+          node-version: "22"
+
       - name: Install Mintlify globally
         run: npm install -g mintlify
 

.gitignore

@@ -4,3 +4,67 @@ node_modules
 # IDE
 .vscode
 *.code-workspace
+
+# V2
+# ------------------------------------
+# Node
+# ------------------------------------
+# node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Optional: ignore local `.env` files
+.env
+.env.*local
+
+# ------------------------------------
+# Logs
+# ------------------------------------
+logs/
+*.log
+*.log.*
+debug.log
+
+# ------------------------------------
+# OS / Editor files
+# ------------------------------------
+# .DS_Store
+Thumbs.db
+.idea/
+
+# VSCode — allow settings.json, ignore rest
+# .vscode/*
+# !.vscode/settings.json
+# !.vscode/extensions.json
+
+# ------------------------------------
+# Mintlify / Build Stuff
+# ------------------------------------
+.mintlify/
+.mintlify-cache/
+.out/
+dist/
+build/
+
+# ------------------------------------
+# Temporary files
+# ------------------------------------
+*.tmp
+*.temp
+*.swp
+*.swo
+
+# ------------------------------------
+# TypeScript
+# ------------------------------------
+*.tsbuildinfo
+
+# ------------------------------------
+# External docs (fetched at build time)
+# ------------------------------------
+snippets/external/

.speakeasy/workflow.yaml

@@ -1,25 +1,25 @@
 workflowVersion: 1.0.0
 speakeasyVersion: latest
 sources:
-    livepeer-ai-api:
-        inputs:
-            - location: https://raw.githubusercontent.com/livepeer/ai-worker/main/runner/gateway.openapi.yaml
-        overlays:
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-js/main/codeSamples.yaml
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-go/main/codeSamples.yaml
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-python/main/codeSamples.yaml
-        output: ai/api-reference/gateway.openapi.yaml
-        registry:
-            location: registry.speakeasyapi.dev/livepeer/livepeer-ai/livepeer-ai-oas
-    livepeer-studio-api:
-        inputs:
-            - location: https://raw.githubusercontent.com/livepeer/studio/master/packages/api/src/schema/api-schema.yaml
-            - location: https://raw.githubusercontent.com/livepeer/studio/master/packages/api/src/schema/ai-api-schema.yaml
-        overlays:
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-js/main/codeSamples.yaml
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-go/main/codeSamples.yaml
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-python/main/codeSamples.yaml
-        output: openapi.yaml
-        registry:
-            location: registry.speakeasyapi.dev/livepeer/livepeer-studio/livepeer-studio-api
+  livepeer-ai-api:
+    inputs:
+      - location: https://raw.githubusercontent.com/livepeer/ai-worker/main/runner/gateway.openapi.yaml
+    overlays:
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-js/main/codeSamples.yaml
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-go/main/codeSamples.yaml
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-python/main/codeSamples.yaml
+    output: ai/api-reference/gateway.openapi.yaml
+    registry:
+      location: registry.speakeasyapi.dev/livepeer/livepeer-ai/livepeer-ai-oas
+  livepeer-studio-api:
+    inputs:
+      - location: https://raw.githubusercontent.com/livepeer/studio/master/packages/api/src/schema/api-schema.yaml
+      - location: https://raw.githubusercontent.com/livepeer/studio/master/packages/api/src/schema/ai-api-schema.yaml
+    overlays:
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-js/main/codeSamples.yaml
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-go/main/codeSamples.yaml
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-python/main/codeSamples.yaml
+    output: openapi.yaml
+    registry:
+      location: registry.speakeasyapi.dev/livepeer/livepeer-studio/livepeer-studio-api
 targets: {}

README.md

@@ -12,5 +12,5 @@ npm i -g mintlify
 Run the following command at the root of your documentation (where mint.json is)
 
 ```bash
-mintlify dev
+mint dev
 ```