Skip to content

docs: update theme 1.9#121

Open
dgarcia360 wants to merge 2 commits intoscylladb:masterfrom
dgarcia360:docs-update-1.9
Open

docs: update theme 1.9#121
dgarcia360 wants to merge 2 commits intoscylladb:masterfrom
dgarcia360:docs-update-1.9

Conversation

@dgarcia360
Copy link

@dgarcia360 dgarcia360 commented Mar 12, 2026

Motivation

Upgrades Sphinx to 9.x, MyST Parser to 5.x, Python to 3.11+–3.14, Node.js to 22, and replaces Poetry with uv for dependency management.

Changelog: https://github.com/scylladb/sphinx-scylladb-theme/blob/master/docs/source/upgrade/CHANGELOG.md#190---26-february-2026

How to test

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

    python --version
    
  2. Install uv:

    make setupenv
    
  3. Build the docs:

    make preview
    
  4. Docs should render without errors at http://127.0.0.1:5500

Comment on lines +30 to +32
python-version: '3.12'
- name: Install uv
uses: astral-sh/setup-uv@v6
Copy link
Collaborator

Choose a reason for hiding this comment

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

There is v7 of that job already.

Copy link
Author

@dgarcia360 dgarcia360 Mar 16, 2026

Choose a reason for hiding this comment

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

Good catch! This PR was auto-propagated across +20 repos. We can bump to v7 in a follow-up after merging.

Comment on lines +18 to +19
permissions:
contents: write
Copy link
Collaborator

Choose a reason for hiding this comment

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

Any here we have it again :( why?

Copy link
Author

Choose a reason for hiding this comment

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

We are now explicitly defining the minimum required permissions per workflow. The contents: write permission is needed here because deploy.sh pushes the built docs to the gh-pages branch.

fix: requires python 3.11
@dgarcia360 dgarcia360 requested a review from Lorak-mmk March 16, 2026 17:38
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