← 返回首页
Infra: bump Sphinx to >8.1, limit docutils to <0.22 by Secrus · Pull Request #4926 · python/peps · GitHub
Skip to content

Navigation Menu

Toggle navigation
Sign in
Appearance settings
Search or jump to...

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted
Cancel Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Cancel Create saved search
Appearance settings
Resetting focus

Infra: bump Sphinx to >8.1, limit docutils to <0.22#4926

Draft
Secrus wants to merge 1 commit into
python:mainfrom
Secrus:sphinx-9
Draft

Infra: bump Sphinx to >8.1, limit docutils to <0.22#4926
Secrus wants to merge 1 commit into
python:mainfrom
Secrus:sphinx-9

Conversation

Copy link
Copy Markdown
Contributor

Secrus commented Apr 18, 2026 •
edited
Loading

Blocked by: #4908, #4906
Closes: #4087

Bump Sphinx to > 8.1. docutils is upper limited because of build errors listed in #4924.

📚 Documentation preview 📚: https://pep-previews--4926.org.readthedocs.build/

hugovk added the infra Core infrastructure for building and rendering PEPs label Apr 18, 2026
Secrus mentioned this pull request Apr 19, 2026
Open
Copy link
Copy Markdown
Contributor Author

Secrus commented Apr 21, 2026

@hugovk, since there is only one PEP left on the #4087 list, could you please review the proposed change? I am mostly interested in knowing what the policy for older Sphinx versions is, and whether I should go with a lower base for the version range.

Copy link
Copy Markdown
Member

hugovk commented Apr 21, 2026

Let's not set a higher version than needed, but if we have a good reason for bumping it, I think that's fine.

Something to note, Sphinx does drop older Python sooner than many projects. For example, Sphinx 9.1.0 requires Python 3.12 or newer.

But then people writing PEPs are targeting changes in 3.15 and soon 3.16 :)

Secrus force-pushed the sphinx-9 branch 2 times, most recently from c4ad377 to 842b11d Compare April 22, 2026 08:20
Secrus changed the title Infra: bump Sphinx to >=9.1, limit docutils to <0.22 Infra: bump Sphinx to >8.1, limit docutils to <0.22 Apr 22, 2026
Copy link
Copy Markdown
Contributor Author

Secrus commented Apr 22, 2026

Ok, I have set the Sphinx requirement to > 8.1 to prevent the errors we were fixing. That seems like a reasonable middle ground.

This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Show hidden characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

AA-Turner Awaiting requested review from AA-Turner AA-Turner will be requested when the pull request is marked ready for review AA-Turner is a code owner

hugovk Awaiting requested review from hugovk hugovk will be requested when the pull request is marked ready for review hugovk is a code owner

Assignees

No one assigned

Labels

infra Core infrastructure for building and rendering PEPs

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Infra: Fix footnote warnings and allow Sphinx 8.1+

2 participants

Footer

© 2026 GitHub, Inc.