setup main branch dev version

Author: Roger-luo

.github/workflows/devdoc.yml

@@ -0,0 +1,48 @@
+name: Deploy Devopment Branch Docs
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  documentation:
+    name: Deploy dev documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+        # Install a specific version of uv.
+          version: "0.5.1"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+      - name: Install Documentation dependencies
+        run: uv sync --group doc
+      - name: Set up build cache
+        uses: actions/cache@v4
+        id: cache
+        with:
+          key: mkdocs-material-${{ github.ref }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      # derived from:
+      # https://github.com/RemoteCloud/public-documentation/blob/dev/.github/workflows/build_docs.yml
+      - name: Configure Git user
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+      - name: Deploy documentation
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          GOOGLE_ANALYTICS_KEY: ${{ secrets.GOOGLE_ANALYTICS_KEY }}
+        run: |
+          git fetch origin gh-pages --depth=1
+          uv run mike deploy -p dev

mkdocs.yml

@@ -127,6 +127,8 @@ markdown_extensions:
 copyright: Copyright © 2024 Kirin contributors
 
 extra:
+  version:
+    provider: mike
   social:
     - icon: simple/x
       link: https://x.com/QueraComputing