Skip to content

chore: Upgrade theme to 1.9: Sphinx 9, uv, Python 3.11+, Node 22#1576

Merged
dgarcia360 merged 7 commits intomasterfrom
update-python-sphinx
Mar 3, 2026
Merged

chore: Upgrade theme to 1.9: Sphinx 9, uv, Python 3.11+, Node 22#1576
dgarcia360 merged 7 commits intomasterfrom
update-python-sphinx

Conversation

@dgarcia360
Copy link
Collaborator

@dgarcia360 dgarcia360 commented Feb 27, 2026

Motivation

This release upgrades the core toolchain: Sphinx 9.x, myst-parser 5.x, Python 3.11+-3.14, Node.js 22, and replaces Poetry with uv for dependency management.

The bundled sphinx-multiversion extension has been updated for Sphinx 9 compatibility.

How to test

  1. Make sure you are using Python 3.11-3.14:

    python --version

  2. Install uv first:

    make setupenv

  3. Then build the docs:

    make preview
    

Next steps

I'll release a new version and help projects migrate from 1.8 to 1.9. See the upgrade guide for step-by-step instructions.

@dgarcia360 dgarcia360 marked this pull request as draft February 27, 2026 17:41
@dgarcia360 dgarcia360 marked this pull request as ready for review February 27, 2026 18:19
Copy link
Collaborator

@annastuchlik annastuchlik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@dgarcia360 dgarcia360 force-pushed the update-python-sphinx branch 2 times, most recently from 92d3874 to 478e6a2 Compare March 3, 2026 12:58
This release upgrades the core toolchain: Sphinx 9.x, myst-parser 5.x, Python 3.11+, Node.js 22, and replaces Poetry with uv for dependency management.

The bundled sphinx-multiversion extension has been updated for Sphinx 9 compatibility.

1. Install uv first:

make setupenv

2. Then set up the environment and build the docs:

make setup
make preview

We'll help projects migrate from 1.8 to 1.9. See the upgrade guide for step-by-step instructions.
@dgarcia360 dgarcia360 force-pushed the update-python-sphinx branch from 478e6a2 to 02d2a97 Compare March 3, 2026 12:58
@dgarcia360 dgarcia360 merged commit 71eb926 into master Mar 3, 2026
8 checks passed
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.

2 participants