Skip to content

Modernize the docs build toolchain - #2495

Merged
3b1b merged 1 commit into
masterfrom
docs/modernize-sphinx
Aug 10, 2026
Merged

3b1b merged 1 commit into
masterfrom
docs/modernize-sphinx

Conversation

@3b1b

@3b1b 3b1b commented Aug 10, 2026

Copy link
Copy Markdown
Owner

The docs job has failed on every run since at least February. It pinned Sphinx to 3.0.3 (2020) while leaving Jinja2 unbounded, so pip resolved Jinja2 3.1, which dropped environmentfilter and sphinx.util.rst failed to import before any page was read.

Move to current Sphinx and furo, and bound both so a future major cannot break the build unnoticed. The build otherwise needed no changes; the manim-example directive works as is.

Pin the interpreter with setup-python rather than inheriting whatever ubuntu-latest ships, and drop the manimlib install along with the setuptools and pango packages it needed. Nothing in docs/source uses autodoc, so the build never imported manimlib.

The docs job has failed on every run since at least February. It pinned
Sphinx to 3.0.3 (2020) while leaving Jinja2 unbounded, so pip resolved
Jinja2 3.1, which dropped environmentfilter, and sphinx.util.rst failed
to import before any page was read.

Move to current Sphinx and furo, and bound both so a future major cannot
break the build unnoticed. The build otherwise needed no changes; the
manim-example directive works as is.

Pin the interpreter with setup-python rather than inheriting whatever
ubuntu-latest ships, and drop the manimlib install along with the
setuptools and pango packages it needed. Nothing in docs/source uses
autodoc, so the build never imported manimlib.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@3b1b
3b1b merged commit 013d976 into master Aug 10, 2026
2 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.

1 participant