From 47584346023db472c1b72c0c1a7a4e9db79f2911 Mon Sep 17 00:00:00 2001 From: David Hernando Date: Fri, 8 May 2026 10:16:54 +0200 Subject: [PATCH] Fix DocFX GitHub Action by replacing broken Docker-based action The davidatwhiletrue/docfx-action@v1.0.0 uses a mono:latest base image based on Debian Buster, which reached End-of-Life in June 2024. apt update fails because Buster repositories have been archived. Replace the custom action with: - actions/checkout@v4 - actions/setup-dotnet@v4 with .NET 8 - docfx installed as a .NET global tool - peaceiris/actions-gh-pages@v4 for publishing This bypasses the broken Mono/Debian Buster Docker image entirely. Signed-off-by: David Hernando --- .github/workflows/docfx-publish.yml | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/.github/workflows/docfx-publish.yml b/.github/workflows/docfx-publish.yml index 4ccdeef..a831ed2 100644 --- a/.github/workflows/docfx-publish.yml +++ b/.github/workflows/docfx-publish.yml @@ -13,13 +13,22 @@ jobs: runs-on: ubuntu-latest name: Generate and publish the docs steps: - - uses: actions/checkout@v1 - name: Checkout code - - uses: davidatwhiletrue/docfx-action@v1.0.0 - name: Build and Publish Documentation + - name: Checkout code + uses: actions/checkout@v6 + + - name: Setup .NET + uses: actions/setup-dotnet@v5 with: - args: Docs/docfx.json - env: - BUILD_DIR: Docs/_site # docfx's default output directory is _site - GH_PAT: ${{ secrets.GH_PAT }} # See https://github.com/maxheld83/ghpages + dotnet-version: '8.0.x' + + - name: Install DocFX + run: dotnet tool install -g docfx + - name: Build Documentation + run: docfx Docs/docfx.json + + - name: Publish to GitHub Pages + uses: peaceiris/actions-gh-pages@v4 + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_dir: Docs/_site