Skip to content

docs: Bump docs dependency versions (sphinx, breathe, etc) - #2192

Open
lgritz wants to merge 1 commit into
AcademySoftwareFoundation:mainfrom
lgritz:lg-brokendocs
Open

lgritz wants to merge 1 commit into
AcademySoftwareFoundation:mainfrom
lgritz:lg-brokendocs

Conversation

@lgritz

@lgritz lgritz commented Oct 26, 2026

Copy link
Copy Markdown
Collaborator

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

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 <lg@larrygritz.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant