From 86677168679461383e7c85150b27016bc757601a Mon Sep 17 00:00:00 2001 From: Larry Gritz Date: Sun, 25 Oct 2026 18:03:58 -0700 Subject: [PATCH] docs: Bump docs dependency versions (sphinx, breathe, etc) The docs workflow broke when GitHub's ubuntu-latest runner moved to Ubuntu 26.04, whose system Python is 3.14. Follow OpenImageIO's approach (AcademySoftwareFoundation/OpenImageIO#5536) and move to current versions instead of pinning an old Python: Sphinx 9.1, Breathe 5.1, MyST-Parser 5.1, Furo 2025.12.19, sphinx-tabs 3.5. Sphinx 9 requires Python 3.12, so docs.yml and .readthedocs.yaml now ask for 3.12. Also drop linkify-it-py from the requirements, since the MyST linkify extension is not enabled in conf.py. Assisted-by: Claude Code / Claude Opus 5.5 Signed-off-by: Larry Gritz --- .github/workflows/docs.yml | 4 ++-- .readthedocs.yaml | 2 +- src/doc/requirements.txt | 11 +++++------ 3 files changed, 8 insertions(+), 9 deletions(-) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 8bbb1a6658..085aef06fb 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -80,10 +80,10 @@ jobs: nametag: docs-linux runner: ubuntu-latest cxx_std: 17 - python_ver: "3.11" + python_ver: "3.12" build_docs: 1 skip_build: 1 skip_tests: 1 setenvs: export EXTRA_DEP_PACKAGES="doxygen sphinx-doc" - PIP_INSTALLS="sphinx breathe==4.34.0 sphinx-tabs furo==2022.6.21 myst-parser linkify-it-py" + PIP_INSTALLS="sphinx>=9.1 breathe>=5.1 sphinx-tabs>=3.5 furo>=2025.12.19 myst-parser>=5.1" SKIP_SYSTEM_DEPS_INSTALL=1 diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 96a3a17aa0..14c636c3aa 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -9,7 +9,7 @@ version: 2 build: os: ubuntu-22.04 tools: - python: "3.11" + python: "3.12" # Build documentation with Sphinx diff --git a/src/doc/requirements.txt b/src/doc/requirements.txt index 221e7a3bca..2197b98c91 100644 --- a/src/doc/requirements.txt +++ b/src/doc/requirements.txt @@ -1,6 +1,5 @@ -sphinx >= 5.0 -breathe == 4.34.0 -sphinx-tabs -furo==2022.6.21 -myst-parser -linkify +sphinx >= 9.1 +breathe >= 5.1 +sphinx-tabs >= 3.5 +furo >= 2025.12.19 +myst-parser >= 5.1