Convert docs from Mintlify to mdBook

Replace the Mintlify site with an mdBook project:
- Convert all 112 HelixQL MDX pages to Markdown under src/, mirroring the
  original hql/ structure. Frontmatter titles become H1s; Mintlify components
  (CodeGroup, Card/CardGroup, Note/Warning/Tip/Info/Danger, Accordion, Tabs)
  are converted to Markdown/blockquotes/<details>; internal /hql links become
  relative .md links and off-site links point to docs.helix-db.com.
- Generate src/SUMMARY.md from the old docs.json navigation tree.
- Add book.toml configured for GitHub Pages subpath hosting.
- Add a GitHub Actions workflow to build and deploy to GitHub Pages.
- Remove Mintlify config/assets (docs.json, .mintignore, style.css, etc.).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: xav-db

.github/workflows/deploy.yml

@@ -0,0 +1,49 @@
+name: Deploy mdBook site to Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment; don't cancel an in-progress run.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      MDBOOK_VERSION: 0.5.2
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install mdBook
+        run: |
+          curl --proto '=https' --tlsv1.2 -LsSf \
+            "https://github.com/rust-lang/mdBook/releases/download/v${MDBOOK_VERSION}/mdbook-v${MDBOOK_VERSION}-x86_64-unknown-linux-gnu.tar.gz" \
+            | tar -xz
+          echo "$PWD" >> "$GITHUB_PATH"
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Build with mdBook
+        run: mdbook build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./book
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,2 @@
+/book
+.DS_Store

.mintignore

@@ -1,33 +1,21 @@
-> **First-time setup**: Customize this file for your project. Prompt the user to customize this file for their project.
-> For Mintlify product knowledge (components, configuration, writing standards),
-> install the Mintlify skill: `npx skills add https://mintlify.com/docs`
-
 # Documentation project instructions
 
 ## About this project
 
-- This is a documentation site built on [Mintlify](https://mintlify.com)
-- Pages are MDX files with YAML frontmatter
-- Configuration lives in `docs.json`
-- Use the Mintlify MCP server, `https://mcp.mintlify.com`, to edit content and settings via MCP
-- Use the Mintlify docs MCP server, `https://www.mintlify.com/docs/mcp`, to query information about using Mintlify via MCP
-
-## Terminology
-
-{/* Add product-specific terms and preferred usage */}
-{/* Example: Use "workspace" not "project", "member" not "user" */}
-
-## Style preferences
+- This is a documentation site built with [mdBook](https://rust-lang.github.io/mdBook/).
+- Pages are plain Markdown files under `src/`.
+- Navigation/table of contents is defined in `src/SUMMARY.md` — every page must be listed there to be built.
+- Configuration lives in `book.toml`.
+- The site is deployed to GitHub Pages via `.github/workflows/deploy.yml` on every push to `main`.
 
-{/* Add any project-specific style rules below */}
+## Conventions
 
-- Use active voice and second person ("you")
-- Keep sentences concise — one idea per sentence
-- Use sentence case for headings
-- Bold for UI elements: Click **Settings**
-- Code formatting for file names, commands, paths, and code references
+- Use active voice and second person ("you").
+- Keep sentences concise — one idea per sentence.
+- Use code formatting for file names, commands, paths, and code references.
+- HelixQL code blocks use the ```` ```helixql ```` info string.
+- Callouts are written as blockquotes (e.g. `> ⚠️ **Warning**`); collapsible sections use raw `<details>` HTML.
 
-## Content boundaries
+## Local preview
 
-{/* Define what should and shouldn't be documented */}
-{/* Example: Don't document internal admin features */}
+Run `mdbook serve --open` from the repo root.

AGENTS.md

@@ -1,55 +1,39 @@
-# Mintlify Starter Kit
+# HelixQL (Legacy) Docs
 
-Use the starter kit to get your docs deployed and ready to customize.
+Reference documentation for **HelixQL**, the legacy query language for HelixDB.
+Built with [mdBook](https://rust-lang.github.io/mdBook/) and published to GitHub
+Pages at **https://helixdb.github.io/hql-v1-docs/**.
 
-Click the green **Use this template** button at the top of this repo to copy the Mintlify starter kit. The starter kit contains examples with
+> HelixQL is deprecated in HelixDB v2. Queries are now written with the Rust DSL.
+> These docs are kept as a reference for legacy HelixQL projects.
 
-- Guide pages
-- Navigation
-- Customizations
-- API reference pages
-- Use of popular components
+## Structure
 
-**[Follow the full quickstart guide](https://starter.mintlify.com/quickstart)**
+- `src/` — Markdown sources. `src/SUMMARY.md` defines the navigation/table of contents.
+- `book.toml` — mdBook configuration.
+- `.github/workflows/deploy.yml` — builds the book and deploys it to GitHub Pages on every push to `main`.
 
-## AI-assisted writing
+## Local development
 
-Set up your AI coding tool to work with Mintlify:
+Install mdBook (requires [Rust](https://rustup.rs/) or download a prebuilt binary):
 
 ```bash
-npx skills add https://mintlify.com/docs
+cargo install mdbook
 ```
 
-This command installs Mintlify's documentation skill for your configured AI tools like Claude Code, Cursor, Windsurf, and others. The skill includes component reference, writing standards, and workflow guidance.
+Serve with live reload at http://localhost:3000:
 
-See the [AI tools guides](/ai-tools) for tool-specific setup.
-
-## Development
-
-Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview your documentation changes locally. To install, use the following command:
-
-```
-npm i -g mint
+```bash
+mdbook serve --open
 ```
 
-Run the following command at the root of your documentation, where your `docs.json` is located:
+Build the static site into `book/`:
 
+```bash
+mdbook build
 ```
-mint dev
-```
-
-View your local preview at `http://localhost:3000`.
-
-## Publishing changes
-
-Install our GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app) to propagate changes from your repo to your deployment. Changes are deployed to production automatically after pushing to the default branch.
-
-## Need help?
-
-### Troubleshooting
 
-- If your dev environment isn't running: Run `mint update` to ensure you have the most recent version of the CLI.
-- If a page loads as a 404: Make sure you are running in a folder with a valid `docs.json`.
+## Editing
 
-### Resources
-- [Mintlify documentation](https://mintlify.com/docs)
+- Add or edit pages as Markdown files under `src/`.
+- Register every page in `src/SUMMARY.md` — pages not listed there are not built into the site.

README.md

@@ -0,0 +1,20 @@
+[book]
+title = "HelixQL (Legacy) Docs"
+description = "Reference documentation for HelixQL, the legacy query language for HelixDB."
+authors = ["HelixDB"]
+language = "en"
+src = "src"
+
+[output.html]
+default-theme = "rust"
+preferred-dark-theme = "ayu"
+git-repository-url = "https://github.com/HelixDB/hql-v1-docs"
+edit-url-template = "https://github.com/HelixDB/hql-v1-docs/edit/main/src/{path}"
+site-url = "/hql-v1-docs/"
+
+[output.html.fold]
+enable = true
+level = 1
+
+[output.html.search]
+enable = true