Add public docs site scaffold (#216)

Author: siddsachar

.github/workflows/docs.yml

@@ -0,0 +1,95 @@
+name: Docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - ".github/workflows/docs.yml"
+      - "docs-site/**"
+      - "docs-content/**"
+      - "scripts/docs/**"
+      - "tests/docs/**"
+      - "README.md"
+      - "RELEASE_NOTES.md"
+      - "src/row_bot/ui/**"
+      - "src/row_bot/designer/**"
+      - "src/row_bot/developer/**"
+      - "src/row_bot/tools/**"
+      - "src/row_bot/providers/**"
+      - "src/row_bot/channels/**"
+      - "src/row_bot/plugins/**"
+      - "src/row_bot/mcp_client/**"
+      - "bundled_skills/**"
+      - "tool_guides/**"
+  pull_request:
+    paths:
+      - ".github/workflows/docs.yml"
+      - "docs-site/**"
+      - "docs-content/**"
+      - "scripts/docs/**"
+      - "tests/docs/**"
+      - "README.md"
+      - "RELEASE_NOTES.md"
+      - "src/row_bot/ui/**"
+      - "src/row_bot/designer/**"
+      - "src/row_bot/developer/**"
+      - "src/row_bot/tools/**"
+      - "src/row_bot/providers/**"
+      - "src/row_bot/channels/**"
+      - "src/row_bot/plugins/**"
+      - "src/row_bot/mcp_client/**"
+      - "bundled_skills/**"
+      - "tool_guides/**"
+
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build docs
+    runs-on: ubuntu-latest
+    env:
+      NO_UPDATE_NOTIFIER: "1"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Python docs dependencies
+        run: python -m pip install pyyaml pytest
+
+      - name: Collect docs inventory
+        run: python scripts/docs/collect_inventory.py --out docs-build/inventory
+
+      - name: Validate docs metadata
+        run: python scripts/docs/validate_public_docs.py
+
+      - name: Generate LLM docs files
+        run: python scripts/docs/generate_llms_txt.py --docs-root docs-site/docs --out-dir docs-site/static
+
+      - name: Run docs automation tests
+        run: pytest tests/docs -q
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+          cache-dependency-path: docs-site/package.json
+
+      - name: Install docs dependencies
+        working-directory: docs-site
+        run: npm ci
+
+      - name: Build docs site
+        working-directory: docs-site
+        run: npm run build:ci

.gitignore

@@ -39,6 +39,10 @@ test-results/
 .backups/
 .copilot_backups/
 .local/
+docs-build/
+docs-site/.docusaurus/
+docs-site/build/
+docs-site/node_modules/
 
 # Dev/test scripts
 seed_knowledge_graph.py

docs-content/metadata/how_to_guides.yml

@@ -0,0 +1,32 @@
+guides:
+  install-row-bot:
+    title: Install Row-Bot
+    route: /docs/getting-started/installation
+    sources:
+      - README.md
+      - installer/README.md
+  first-launch:
+    title: Complete First Launch Setup
+    route: /docs/getting-started/first-launch
+    sources:
+      - src/row_bot/ui/setup_wizard.py
+  create-workflow:
+    title: Create A Workflow
+    route: /docs/guides/workflows
+    sources:
+      - src/row_bot/ui/home.py
+      - src/row_bot/tasks.py
+      - bundled_skills/task_automation/SKILL.md
+  use-designer:
+    title: Use Designer Studio
+    route: /docs/guides/designer-studio
+    sources:
+      - src/row_bot/designer/
+      - bundled_skills/design_creator/SKILL.md
+  use-developer:
+    title: Use Developer Studio
+    route: /docs/guides/developer-studio
+    sources:
+      - src/row_bot/developer/
+      - bundled_skills/developer_coding/SKILL.md
+      - bundled_skills/developer_review/SKILL.md

docs-content/metadata/screenshots.yml

@@ -0,0 +1,127 @@
+screenshots:
+  chat-main:
+    title: Chat Main
+    surface: chat
+    status: planned
+    output: chat-main.png
+    alt: Row-Bot chat surface with sidebar, model picker, composer, and conversation area.
+  chat-model-picker:
+    title: Chat Model Picker
+    surface: chat
+    status: planned
+    output: chat-model-picker.png
+    alt: Row-Bot chat model picker showing provider-qualified model choices.
+  chat-tool-trace:
+    title: Chat Tool Trace
+    surface: chat
+    status: planned
+    output: chat-tool-trace.png
+    alt: Row-Bot chat transcript showing grouped tool activity.
+  chat-approval:
+    title: Chat Approval
+    surface: chat
+    status: planned
+    output: chat-approval.png
+    alt: Row-Bot approval dialog for a sensitive action.
+  home-workflows:
+    title: Workflows Home
+    surface: home_workflows
+    status: planned
+    output: home-workflows.png
+    alt: Row-Bot Home view open to the Workflows tab.
+  designer-gallery:
+    title: Designer Gallery
+    surface: designer
+    status: planned
+    output: designer-gallery.png
+    alt: Row-Bot Designer Studio gallery with design project cards.
+  designer-new-project:
+    title: Designer New Project
+    surface: designer
+    status: planned
+    output: designer-new-project.png
+    alt: Row-Bot Designer Studio new project dialog.
+  designer-editor:
+    title: Designer Editor
+    surface: designer
+    status: planned
+    output: designer-editor.png
+    alt: Row-Bot Designer Studio editor with chat, preview, and page controls.
+  developer-home:
+    title: Developer Home
+    surface: developer
+    status: planned
+    output: developer-home.png
+    alt: Row-Bot Developer Studio home showing workspaces and Custom Tools.
+  developer-workspace:
+    title: Developer Workspace
+    surface: developer
+    status: planned
+    output: developer-workspace.png
+    alt: Row-Bot Developer Studio workspace inspector.
+  knowledge-graph:
+    title: Knowledge Graph
+    surface: knowledge
+    status: planned
+    output: knowledge-graph.png
+    alt: Row-Bot Knowledge graph visualization and memory controls.
+  settings-providers-overview:
+    title: Settings Providers
+    surface: settings
+    status: planned
+    output: settings-providers-overview.png
+    alt: Row-Bot Settings dialog open to Providers.
+  settings-models-catalog:
+    title: Settings Models
+    surface: settings
+    status: planned
+    output: settings-models-catalog.png
+    alt: Row-Bot Settings dialog open to Models and Model Catalog.
+  settings-knowledge:
+    title: Settings Knowledge
+    surface: settings
+    status: planned
+    output: settings-knowledge.png
+    alt: Row-Bot Settings dialog open to Knowledge.
+  settings-skills:
+    title: Settings Skills
+    surface: settings
+    status: planned
+    output: settings-skills.png
+    alt: Row-Bot Settings dialog open to Skills.
+  settings-channels:
+    title: Settings Channels
+    surface: settings
+    status: planned
+    output: settings-channels.png
+    alt: Row-Bot Settings dialog open to Channels.
+  settings-voice:
+    title: Settings Voice
+    surface: settings
+    status: planned
+    output: settings-voice.png
+    alt: Row-Bot Settings dialog open to Voice.
+  settings-mcp:
+    title: Settings MCP
+    surface: settings
+    status: planned
+    output: settings-mcp.png
+    alt: Row-Bot Settings dialog open to MCP.
+  settings-plugins:
+    title: Settings Plugins
+    surface: settings
+    status: planned
+    output: settings-plugins.png
+    alt: Row-Bot Settings dialog open to Plugins.
+  skills-hub-browse:
+    title: Skills Hub Browse
+    surface: skills_hub
+    status: planned
+    output: skills-hub-browse.png
+    alt: Row-Bot Skills Hub browsing public skills.
+  buddy-settings:
+    title: Buddy Settings
+    surface: buddy
+    status: planned
+    output: buddy-settings.png
+    alt: Row-Bot Buddy settings for companion behavior and appearance.

docs-content/metadata/settings.yml

@@ -0,0 +1,55 @@
+tabs:
+  Providers:
+    description: Connect hosted, subscription, local, cloud, and custom model providers.
+    docs_route: /docs/configuration/models-and-providers
+    screenshot_id: settings-providers-overview
+  Models:
+    description: Pin model Quick Choices, choose defaults, and review catalog metadata.
+    docs_route: /docs/configuration/models-and-providers
+    screenshot_id: settings-models-catalog
+  Knowledge:
+    description: Configure memory, document knowledge, graph review, embeddings, and wiki export.
+    docs_route: /docs/ui-tour/
+    screenshot_id: settings-knowledge
+  Buddy:
+    description: Configure companion behavior, look, overlay mode, and generated motion.
+    docs_route: /docs/guides/channels-and-voice
+    screenshot_id: buddy-settings
+  Voice:
+    description: Configure dictation, realtime talk, read-aloud, voice models, and diagnostics.
+    docs_route: /docs/guides/channels-and-voice
+    screenshot_id: settings-voice
+  System:
+    description: Configure workspace paths, app preferences, startup behavior, tunnel settings, logging, and updates.
+    docs_route: /docs/reference/
+  Tracker:
+    description: Configure habit and health tracker views, charts, and logged data.
+    docs_route: /docs/reference/
+  Documents:
+    description: Manage uploaded documents, document search, extraction, and vector indexing.
+    docs_route: /docs/ui-tour/
+  Search:
+    description: Configure search providers, browser automation, and knowledge/search tools.
+    docs_route: /docs/reference/
+  Skills:
+    description: Enable, disable, pin, browse, and review Smart Skills.
+    docs_route: /docs/guides/skills-plugins-mcp
+    screenshot_id: settings-skills
+  Accounts:
+    description: Connect account-level integrations used by tools and setup flows.
+    docs_route: /docs/configuration/models-and-providers
+  Channels:
+    description: Configure Telegram, WhatsApp, Discord, Slack, SMS, delivery, and health checks.
+    docs_route: /docs/guides/channels-and-voice
+    screenshot_id: settings-channels
+  Utilities:
+    description: Configure built-in utility tools and system integrations.
+    docs_route: /docs/reference/
+  MCP:
+    description: Add, test, import, browse, enable, and troubleshoot external MCP servers.
+    docs_route: /docs/guides/skills-plugins-mcp
+    screenshot_id: settings-mcp
+  Plugins:
+    description: Manage installed plugins, marketplace installs, and promoted Custom Tools.
+    docs_route: /docs/guides/skills-plugins-mcp
+    screenshot_id: settings-plugins