Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 43 additions & 20 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
@@ -1,37 +1,60 @@
name: docs
permissions:
contents: write
contents: read

on:
push:
tags:
- "v*"
branches:
- main

concurrency:
group: "pages"
cancel-in-progress: false

env:
EM_CACHE_FOLDER: 'emsdk-cache'

jobs:
docs:
build:
runs-on: ubuntu-latest

steps:
- uses: actions/checkout@v6

- name: recovery tag information
run: git fetch --tags --force
- uses: actions/setup-node@v6
with:
node-version: 'latest'
Copy link

Copilot AI Jan 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The node-version value 'latest' is not a valid version specifier for actions/setup-node. This action expects a specific version number (e.g., '20', '22', '24') or a semantic version range (e.g., '20.x'). Using 'latest' will likely cause the workflow to fail. Consider using a specific Node.js version like '24' to match the other workflows in this repository.

Suggested change
node-version: 'latest'
node-version: '24'

Copilot uses AI. Check for mistakes.
cache: 'npm'

- uses: astral-sh/setup-uv@v7
- uses: actions/cache@v5
with:
python-version: '3.14'
enable-cache: true
path: ${{ env.EM_CACHE_FOLDER }}
key: docs-em-cache-${{ runner.os }}

- name: install dependencies
run: uv sync --locked --extra docs
- uses: pyodide/setup-emsdk@v15
with:
actions-cache-folder: ${{ env.EM_CACHE_FOLDER }}

- name: configure git
run: |
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
- name: dependencies
run: npm ci

- name: build docs
run: uv run mike deploy --push --update-aliases --alias-type=redirect ${GITHUB_REF#refs/tags/} latest
- name: build
run: npm run docs

- name: set default
run: uv run mike set-default --push latest
- uses: actions/upload-pages-artifact@v3
with:
path: .vitepress/dist
Copy link

Copilot AI Jan 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The artifact path appears to be incorrect. According to the VitePress configuration in .vitepress/config.mts, the srcDir is set to "docs", which means VitePress will build the output to docs/.vitepress/dist, not .vitepress/dist at the repository root. The path should be changed to 'docs/.vitepress/dist' to correctly upload the built documentation artifacts.

Suggested change
path: .vitepress/dist
path: docs/.vitepress/dist

Copilot uses AI. Check for mistakes.

deploy:
runs-on: ubuntu-latest
needs: build

environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
permissions:
pages: write
id-token: write

steps:
- id: deployment
uses: actions/deploy-pages@v4