From 996daf6a4b3043b94ce6cca3149115e563ff22ee Mon Sep 17 00:00:00 2001
From: Jani Nikula <jani@nikula.org>
Date: Tue, 22 Aug 2023 22:48:35 +0300
Subject: [PATCH] github: generate documentation version matrix dynamically

Updating the release tag in docs.yml is tedious. Generate the action
matrix dynamically.
---
 .github/config.sh          | 23 +++++++++++++++++++++++
 .github/workflows/docs.yml | 21 +++++++++++++++------
 2 files changed, 38 insertions(+), 6 deletions(-)
 create mode 100755 .github/config.sh

diff --git a/.github/config.sh b/.github/config.sh
new file mode 100755
index 00000000..8b706158
--- /dev/null
+++ b/.github/config.sh
@@ -0,0 +1,23 @@
+#!/bin/bash
+# Copyright (c) 2023, Jani Nikula <jani@nikula.org>
+# Licensed under the terms of BSD 2-Clause, see LICENSE for details.
+
+# Output a json matrix for building multiple versions of documentation
+
+# Can't use git describe unless full history has been fetched!
+release=$(git tag --list --sort=version:refname | tail -1)
+
+jq -c . <<EOF
+{
+  "include": [
+    {
+      "ref": "master",
+      "name": "dev"
+    },
+    {
+      "ref": "$release",
+      "name": "stable"
+    }
+  ]
+}
+EOF
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 856b6a22..c83e1768 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -6,16 +6,25 @@ on:
       - 'master'
 
 jobs:
+  configure:
+    name: Configure Versions
+    runs-on: ubuntu-latest
+    outputs:
+      matrix: ${{ steps.version-matrix.outputs.matrix }}
+    steps:
+      - uses: actions/checkout@v3
+      - name: Fetch tags
+        run: git fetch --tags origin
+      - name: Set version matrix
+        id: version-matrix
+        run: echo "matrix=$(./.github/config.sh)" | tee $GITHUB_OUTPUT
+
   build-docs:
     name: Build Documentation
     runs-on: ubuntu-latest
+    needs: configure
     strategy:
-      matrix:
-        include:
-          - ref: master
-            name: dev
-          - ref: v0.15.0
-            name: stable
+      matrix: ${{ fromJson(needs.configure.outputs.matrix) }}
     steps:
       - uses: actions/checkout@v3
         with: