From 5d1e915a8f3dce04d954c342e80cab15b6242525 Mon Sep 17 00:00:00 2001
From: pmaybank <113125070+pmaybank@users.noreply.github.com>
Date: Mon, 27 Oct 2025 11:11:13 +0000
Subject: [PATCH] Update cmake/SetupDocs.cmake

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 cmake/SetupDocs.cmake | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/cmake/SetupDocs.cmake b/cmake/SetupDocs.cmake
index 932aa66a63..386d373251 100644
--- a/cmake/SetupDocs.cmake
+++ b/cmake/SetupDocs.cmake
@@ -84,9 +84,11 @@ function(setup_documentation)
     set(SPHINX_OUTPUT_DIR "${CMAKE_BINARY_DIR}/docs/html")
     set(SPHINX_SOURCE_DIR "${CMAKE_SOURCE_DIR}/docs")
     
-    # Set number of parallel jobs for Sphinx (default to 8 if not set)
+    # Set number of parallel jobs for Sphinx.
+    # Use 8 as a reasonable default for modern multi-core machines if not set by the user.
+    set(SPHINX_DEFAULT_PARALLEL_JOBS 8)
     if(NOT CMAKE_BUILD_PARALLEL_LEVEL)
-        set(CMAKE_BUILD_PARALLEL_LEVEL 8)
+        set(CMAKE_BUILD_PARALLEL_LEVEL ${SPHINX_DEFAULT_PARALLEL_JOBS})
     endif()
     
     add_custom_target(docs