From b2b9b0562e6069d018faef42b9d07f4c07bf8065 Mon Sep 17 00:00:00 2001 From: ChrisRackauckas Date: Sun, 31 May 2026 10:40:36 +0000 Subject: [PATCH 1/2] ci(docs): restore Documentation workflow on GitHub Actions (CPU runner) Docs CI was removed from GHA in #99 (2024-07) and #130 to restore it was closed unmerged, so `main` has had no documentation workflow. As a result `stable` is frozen at v1.2.1 (2022): no v2.x release ever deployed docs. The v2.x tag builds that did run used a self-hosted GPU runner and segfaulted (exit 139) during `docs/make.jl` ExpandTemplates, crashing before `deploydocs`. Every executed `@example` block uses `use_cuda = false` (the `use_cuda = true` snippets are static, non-executed fences), so the build needs no GPU. Running on `ubuntu-latest` avoids the segfault and deploys correctly. DOCUMENTER_KEY + deploy key are already configured on the repo. Co-Authored-By: Claude Opus 4.8 (1M context) --- .github/workflows/Documentation.yml | 40 +++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 .github/workflows/Documentation.yml diff --git a/.github/workflows/Documentation.yml b/.github/workflows/Documentation.yml new file mode 100644 index 0000000..08e1a24 --- /dev/null +++ b/.github/workflows/Documentation.yml @@ -0,0 +1,40 @@ +name: Documentation + +on: + push: + branches: + - main + tags: ['*'] + pull_request: + workflow_dispatch: + +concurrency: + # Skip intermediate builds: always. + # Cancel intermediate builds: only if it is a pull request build. + group: ${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: ${{ startsWith(github.ref, 'refs/pull/') }} + +jobs: + build: + # Runs on a GitHub-hosted CPU runner (not the self-hosted GPU box). + # All executed `@example` blocks use `use_cuda = false`, so no GPU is + # required; the previous GPU-runner build segfaulted (exit 139) during + # example evaluation, which blocked every v2.x docs deploy. + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: julia-actions/setup-julia@v2 + with: + version: '1' + - uses: julia-actions/cache@v2 + - name: Install dependencies + shell: julia --color=yes --project=docs/ {0} + run: | + using Pkg + Pkg.develop(PackageSpec(path=pwd())) + Pkg.instantiate() + - name: Build and deploy + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # For authentication with GitHub Actions token + DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }} # For authentication with SSH deploy key + run: julia --color=yes --project=docs/ docs/make.jl From 6c04bfb042aa05a781e2d28b77c79b859f30fe79 Mon Sep 17 00:00:00 2001 From: ChrisRackauckas Date: Thu, 12 Nov 2026 10:21:41 -0100 Subject: [PATCH 2/2] ci: remove duplicate GPU documentation publisher Documentation.yml is the single documentation build and deploy workflow; GPU.yml keeps only the GPU test job. Co-Authored-By: Chris Rackauckas Co-Authored-By: Muse Agent-Harness: Muse CLI Code Agent-Model: muse-wonder-full-1.0 Agent-Session: local fixer job SciML__HighDimPDE.jl__142 (no session URL) --- .github/workflows/Documentation.yml | 3 +-- .github/workflows/GPU.yml | 23 ----------------------- 2 files changed, 1 insertion(+), 25 deletions(-) diff --git a/.github/workflows/Documentation.yml b/.github/workflows/Documentation.yml index 08e1a24..8b25816 100644 --- a/.github/workflows/Documentation.yml +++ b/.github/workflows/Documentation.yml @@ -18,8 +18,7 @@ jobs: build: # Runs on a GitHub-hosted CPU runner (not the self-hosted GPU box). # All executed `@example` blocks use `use_cuda = false`, so no GPU is - # required; the previous GPU-runner build segfaulted (exit 139) during - # example evaluation, which blocked every v2.x docs deploy. + # required. runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 diff --git a/.github/workflows/GPU.yml b/.github/workflows/GPU.yml index d4c66e1..d3d45cf 100644 --- a/.github/workflows/GPU.yml +++ b/.github/workflows/GPU.yml @@ -36,26 +36,3 @@ jobs: files: lcov.info token: ${{ secrets.CODECOV_TOKEN }} fail_ci_if_error: false - - gpu-docs: - name: "Documentation" - runs-on: [self-hosted, gpu-v100] - timeout-minutes: 360 - if: github.event_name == 'push' || !github.event.pull_request.draft - steps: - - uses: actions/checkout@v7 - - uses: julia-actions/setup-julia@v3 - with: - version: "1.10" - - run: | - julia --project=docs -e ' - println("--- Instantiating project") - using Pkg - Pkg.develop(PackageSpec(path=pwd())) - Pkg.instantiate() - println("+++ Building documentation") - include("docs/make.jl")' - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} - DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }} - DATADEPS_ALWAYS_ACCEPT: true