From d8b5ec0718c32e1ebf93aa4c071d47fab195e1e8 Mon Sep 17 00:00:00 2001
From: gchqdev227 <62302861+gchqdev227@users.noreply.github.com>
Date: Wed, 1 Oct 2025 10:36:52 +0100
Subject: [PATCH 1/2] Replaced call to deprecated
 docutils.nodes.Element.set_class method

---
 docs/source/extensions/cli.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/source/extensions/cli.py b/docs/source/extensions/cli.py
index 3ebd701..b05c487 100644
--- a/docs/source/extensions/cli.py
+++ b/docs/source/extensions/cli.py
@@ -65,7 +65,7 @@ def run(self) -> list[nodes.Node]:
             for positional in command.positional_arguments:
                 alias_paragraph = nodes.paragraph("", "", nodes.literal("", positional.name))
                 description_paragraph = nodes.paragraph("", positional.description or "")
-                description_paragraph.set_class("cli-option-description")
+                description_paragraph["classes"].append("cli-option-description")
                 command_section.extend([alias_paragraph, description_paragraph])
 
             for option in command.options:
@@ -75,7 +75,7 @@ def run(self) -> list[nodes.Node]:
                     alias_nodes.append(nodes.Text(", "))
                 alias_paragraph = nodes.paragraph("", "", *alias_nodes[:-1])
                 description_paragraph = nodes.paragraph("", option.description or "")
-                description_paragraph.set_class("cli-option-description")
+                description_paragraph["classes"].append("cli-option-description")
                 command_section.extend([alias_paragraph, description_paragraph])
 
             nodes_to_return.append(command_section)

From 962a093da77904a29e3f2de8c9d4873331bd0585 Mon Sep 17 00:00:00 2001
From: gchqdev227 <62302861+gchqdev227@users.noreply.github.com>
Date: Wed, 1 Oct 2025 10:39:49 +0100
Subject: [PATCH 2/2] CI for building documentation now fails on deprecation
 warnings

---
 .github/workflows/documentation.yaml | 2 +-
 cspell.config.yaml                   | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/documentation.yaml b/.github/workflows/documentation.yaml
index 702a275..0579c57 100644
--- a/.github/workflows/documentation.yaml
+++ b/.github/workflows/documentation.yaml
@@ -17,7 +17,7 @@ jobs:
           python -m pip install -r docs/requirements.txt --no-deps
       - name: Build documentation
         run: |
-          python -m sphinx -b html -aE -n -W --keep-going docs/source docs/build
+          python -Werror -m sphinx -b html -aE -n -W --keep-going docs/source docs/build
       - name: Check external links
         run: |
           python -m sphinx -b linkcheck docs/source docs/build
diff --git a/cspell.config.yaml b/cspell.config.yaml
index 49600f7..3e90a39 100644
--- a/cspell.config.yaml
+++ b/cspell.config.yaml
@@ -4,6 +4,7 @@ useGitignore: true
 ignorePaths:
   - tests
   - requirements*.txt
+  - .github/workflows/*
   - .pre-commit-config.yaml
   - .pre-commit-hooks/*
 dictionaries: