From 1ac7b252f5eb61711fcda803b439f9fc95885505 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Benjamin=20Cabe=CC=81?= <benjamin@zephyrproject.org>
Date: Thu, 16 Oct 2025 14:59:40 +0200
Subject: [PATCH] ci: docs: build doxygen documentation in a matrix including
 latest version
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add a matrix to the docs workflow to build the documentation with latest
Doxygen version too.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
---
 .github/workflows/docs.yml | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 1720c1ef..c261fcca 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -8,13 +8,13 @@ on: [push, pull_request]
 permissions:
   contents: read
 
-env:
-  DOXYGEN_VERSION: 1.9.6
-
 jobs:
   build:
     name: Build
     runs-on: ubuntu-22.04
+    strategy:
+      matrix:
+        doxygen-version: [1.9.6, 1.14.0]
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -23,6 +23,7 @@ jobs:
 
       - name: Install dependencies
         run: |
+          DOXYGEN_VERSION="${{ matrix.doxygen-version }}"
           wget --no-verbose "https://github.com/doxygen/doxygen/releases/download/Release_${DOXYGEN_VERSION//./_}/doxygen-${DOXYGEN_VERSION}.linux.bin.tar.gz"
           tar xf doxygen-${DOXYGEN_VERSION}.linux.bin.tar.gz
           echo "${PWD}/doxygen-${DOXYGEN_VERSION}/bin" >> $GITHUB_PATH
@@ -40,11 +41,11 @@ jobs:
           mv _build_sphinx/html/* deploy
 
       - name: Setup pages
-        if: github.event_name != 'pull_request'
+        if: github.event_name != 'pull_request' && matrix.doxygen-version == '1.14.0'
         uses: actions/configure-pages@v4
 
       - name: Upload pages artifact
-        if: github.event_name != 'pull_request'
+        if: github.event_name != 'pull_request' && matrix.doxygen-version == '1.14.0'
         uses: actions/upload-pages-artifact@v3
         with:
           path: doc/deploy
@@ -53,6 +54,7 @@ jobs:
         if: github.event_name == 'pull_request'
         uses: actions/upload-artifact@v4
         with:
+          name: docs-doxygen-${{ matrix.doxygen-version }}
           path: doc/deploy
 
   deploy: