From b4fac83f8e2b1c37a63ccd15781216110a3410e9 Mon Sep 17 00:00:00 2001
From: harryswift01 <harry.swift@stfc.ac.uk>
Date: Wed, 4 Feb 2026 12:30:17 +0000
Subject: [PATCH 1/2] remove support for python `v3.11` due to `Sphinx`
 incompatability

---
 .github/workflows/project-ci.yaml | 22 +++++++++++++++-------
 docs/getting_started.rst          |  2 +-
 pyproject.toml                    |  1 -
 3 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/project-ci.yaml b/.github/workflows/project-ci.yaml
index f070e15..1bea674 100644
--- a/.github/workflows/project-ci.yaml
+++ b/.github/workflows/project-ci.yaml
@@ -15,7 +15,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-24.04, windows-2025, macos-15]
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.12", "3.13", "3.14"]
     steps:
       - name: Checkout repo
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
@@ -38,14 +38,18 @@ jobs:
           parallel: true       
 
   docs:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-24.04, windows-2025, macos-15]
+        python-version: ["3.12", "3.13", "3.14"]
     timeout-minutes: 15
     steps:
       - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
-      - name: Set up Python 3.14
+      - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
-          python-version: 3.14.0
+          python-version: ${{ matrix.python-version }}
       - name: Install python dependencies
         run: |
           pip install --upgrade pip
@@ -54,14 +58,18 @@ jobs:
         run: cd docs && make
 
   pre-commit:
-    runs-on: ubuntu-24.04
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-24.04, windows-2025, macos-15]
+        python-version: ["3.12", "3.13", "3.14"]
     timeout-minutes: 15
     steps:
       - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
-      - name: Set up Python 3.14
+      - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
-          python-version: 3.14.0
+          python-version: ${{ matrix.python-version }}
       - name: Install python dependencies
         run: |
           pip install --upgrade pip
diff --git a/docs/getting_started.rst b/docs/getting_started.rst
index 7fe9071..3d103e4 100644
--- a/docs/getting_started.rst
+++ b/docs/getting_started.rst
@@ -4,7 +4,7 @@ Getting Started
 Requirements
 ----------------
 
-* Python >= 3.11
+* Python >= 3.12
 
 Installation
 ----------------
diff --git a/pyproject.toml b/pyproject.toml
index 095873c..42b7998 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -26,7 +26,6 @@ readme = "README.md"
 license = { file = "LICENSE" }
 classifiers = [
     "Programming Language :: Python",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",

From b50980c8b4df0ae19cb3ae28ae4fe4fadec467fb Mon Sep 17 00:00:00 2001
From: harryswift01 <harry.swift@stfc.ac.uk>
Date: Wed, 4 Feb 2026 12:55:11 +0000
Subject: [PATCH 2/2] fix pre-commit CI on Windows by using bash shell

---
 .github/workflows/project-ci.yaml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/project-ci.yaml b/.github/workflows/project-ci.yaml
index 1bea674..ae8ab9a 100644
--- a/.github/workflows/project-ci.yaml
+++ b/.github/workflows/project-ci.yaml
@@ -75,6 +75,11 @@ jobs:
           pip install --upgrade pip
           pip install -e .[pre-commit]
       - name: Run pre-commit
+        shell: bash
         run: |
           pre-commit install
-          pre-commit run --all-files || ( git status --short ; git diff ; exit 1 )
+          pre-commit run --all-files || {
+            git status --short
+            git diff
+            exit 1
+          }