From 5b4ff199dcc3c878483561979ad7bc9f19782f23 Mon Sep 17 00:00:00 2001
From: Joel Rosdahl <joel@rosdahl.net>
Date: Sun, 17 Aug 2025 14:21:23 +0200
Subject: [PATCH] ci: Add documentation build job

---
 .github/workflows/build.yaml | 36 ++++++++++++++++++++++++------------
 ci/build-docs                |  7 +++++++
 2 files changed, 31 insertions(+), 12 deletions(-)
 create mode 100755 ci/build-docs

diff --git a/.github/workflows/build.yaml b/.github/workflows/build.yaml
index 3502d94d..d4345779 100644
--- a/.github/workflows/build.yaml
+++ b/.github/workflows/build.yaml
@@ -255,6 +255,30 @@ jobs:
           name: ${{ matrix.sys }}-${{ matrix.compiler }}-testdir.tar.xz
           path: testdir.tar.xz
 
+  build_documentation:
+    timeout-minutes: 30
+    name: Documentation
+    runs-on: ubuntu-24.04
+    env:
+      CMAKE_GENERATOR: Ninja
+    steps:
+      - name: Get source
+        uses: actions/checkout@v4
+      - name: Prepare environment
+        run: |
+          sudo apt-get install -y asciidoctor
+      - name: Build documentation
+        run: ci/build-docs
+      - name: Upload documentation
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs
+          path: |
+            doc/INSTALL.md
+            GPL-3.0.txt
+            install
+            README.md
+
   build_linux_aarch64_binary:
     timeout-minutes: 30
     name: Linux aarch64 binary
@@ -507,18 +531,6 @@ jobs:
             SPECIAL: build-and-verify-source-package
             apt_get: elfutils libzstd-dev libhiredis-dev asciidoctor
 
-          - name: HTML documentation
-            os: ubuntu-22.04
-            EXTRA_CMAKE_BUILD_FLAGS: --target doc-html
-            RUN_TESTS: none
-            apt_get: libzstd-dev libhiredis-dev asciidoctor
-
-          - name: Manual page
-            os: ubuntu-22.04
-            EXTRA_CMAKE_BUILD_FLAGS: --target doc-man-page
-            RUN_TESTS: none
-            apt_get: libzstd-dev libhiredis-dev asciidoctor
-
           - name: Clang-Tidy
             os: ubuntu-22.04
             CC: clang-12
diff --git a/ci/build-docs b/ci/build-docs
new file mode 100755
index 00000000..2a9d42d2
--- /dev/null
+++ b/ci/build-docs
@@ -0,0 +1,7 @@
+#!/bin/sh
+
+set -eu
+
+dir=build
+cmake -B "${dir}" -D CMAKE_INSTALL_PREFIX="$(pwd)/install"
+ninja -C "${dir}" doc/install
-- 
2.47.3