Skip to content

Conversation

@amotl
Copy link
Member

@amotl amotl commented Dec 19, 2025

@amotl
Copy link
Member Author

amotl commented Dec 19, 2025

Observation

CI still selects Sphinx 8.x.

Reason

Dependencies are not compatible with Sphinx 9 yet.

furo==2025.9.25 depends on sphinx>=6.0,<9.0
sphinx-design==0.6.1 depends on sphinx>=6,<9

@amotl
Copy link
Member Author

amotl commented Jan 4, 2026

Furo 2025.12.19 is now compatible with Sphinx 9.

sphinx-design needs an update of MyST-Parser.

@amotl
Copy link
Member Author

amotl commented Jan 20, 2026

sphinx-design 0.7.0 was released yesterday, now also including support for Sphinx 9.
This patch will unlock relevant updates:

@coderabbitai

This comment was marked as spam.

@amotl amotl requested review from seut and removed request for seut January 21, 2026 06:20
@amotl amotl marked this pull request as ready for review January 21, 2026 06:21
@amotl amotl requested review from matriv and seut January 21, 2026 06:22
Copy link

@matriv matriv left a comment

Choose a reason for hiding this comment

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

thx, left a question.
Would be great to test github.com/crate/crate docs are building correctly after this change, thx!

intersphinx_mapping["sde"] = ("https://sphinx-design-elements.readthedocs.io/en/latest/", None)


linkcheck_ignore += [
Copy link

Choose a reason for hiding this comment

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

why is this required?

Copy link
Member Author

@amotl amotl Jan 21, 2026

Choose a reason for hiding this comment

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

Just some project-local rate limiting against github.com when building the docs here.

@amotl
Copy link
Member Author

amotl commented Jan 21, 2026

Would be great to test github.com/crate/crate docs are building correctly after this change, thx!

The unlocking of Sphinx 9 has been successfully validated on those downstream projects using the pre-release package crate-docs-theme==0.47.1.dev5.

@amotl amotl merged commit 1781583 into main Jan 21, 2026
9 checks passed
@amotl amotl deleted the sphinx9 branch January 21, 2026 11:29
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.

3 participants