Title: Increase minimum supported Sphinx to 7.2.6 · Issue #125277 · python/cpython · GitHub
Open Graph Title: Increase minimum supported Sphinx to 7.2.6 · Issue #125277 · python/cpython
X Title: Increase minimum supported Sphinx to 7.2.6 · Issue #125277 · python/cpython
Description: Documentation Python 3.13 has been released, so I looked to review the minimum Sphinx version. Using the same survey as #109209 (comment) and #117928: Distro CPython Sphinx Debian 13 Trixie (testing) 3.12.6 7.4.7 Debian Sid (unstable) 3....
Open Graph Description: Documentation Python 3.13 has been released, so I looked to review the minimum Sphinx version. Using the same survey as #109209 (comment) and #117928: Distro CPython Sphinx Debian 13 Trixie (testin...
X Description: Documentation Python 3.13 has been released, so I looked to review the minimum Sphinx version. Using the same survey as #109209 (comment) and #117928: Distro CPython Sphinx Debian 13 Trixie (testin...
Opengraph URL: https://github.com/python/cpython/issues/125277
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Increase minimum supported Sphinx to 7.2.6","articleBody":"# Documentation\r\n\r\nPython 3.13 has been released, so I looked to review the minimum Sphinx version.\r\n\r\nUsing the same survey as https://github.com/python/cpython/issues/109209#issuecomment-1713859051 and #117928:\r\n\r\nDistro | CPython| Sphinx\r\n-- | --: | --:\r\nDebian 13 Trixie (testing) | 3.12.6 | 7.4.7\r\nDebian Sid (unstable) | 3.12.6 | 7.4.7\r\nDebian (experimental) | 3.12.6 | *N/A*\r\nFedora 39 (EOL 12/11/2024) | 3.12.6 | **6.2.1**\r\nFedora 40 | 3.12.6 | 7.2.6\r\nFedora 41 | 3.13.0 | 7.3.7\r\nFedora rawhide | 3.13.0 | 7.3.7\r\nGentoo | *N/A* | *N/A*\r\nopenSUSE Leap | | 8.0.2\r\nopenSUSE Tumbleweed | | 8.0.2\r\nRHEL | *N/A* | *N/A*\r\n**_Minimum Sphinx version for 3.12_** | **_3.12_** | **_7.2.6_** †\r\n\r\n† The blocker to updating is Fedora 39, which is end-of-life in a month's time. cc @hroncok -- would you prefer we wait until November until the actual EOL date?\r\n\r\nSphinx 7.2 has support for documenting generic classes and [`:no-typesetting:`](https://www.sphinx-doc.org/en/master/usage/domains/index.html#basic-markup). Sadly [`.. py:type::`](https://www.sphinx-doc.org/en/master/usage/domains/python.html#directive-py-type) is new in Sphinx 7.4, so we need to wait for Fedora 40's end-of-life (13 May 2025) to use it.\r\n\r\nReferences:\r\n\r\n* https://qa.debian.org/madison.php?package=python3\r\n* https://qa.debian.org/madison.php?package=sphinx\r\n* https://packages.debian.org/trixie/python3\r\n* https://packages.debian.org/trixie/python3-sphinx\r\n* https://fedorapeople.org/groups/schedule/f-39/f-39-key-tasks.html\r\n* https://packages.fedoraproject.org/pkgs/python3.12/python3/\r\n* https://packages.fedoraproject.org/pkgs/python3.13/python3/\r\n* https://packages.fedoraproject.org/pkgs/python-sphinx/python3-sphinx/\r\n* https://software.opensuse.org/package/python-Sphinx\r\n\r\ncc:\r\n\r\n* @doko42 @mitya57 / Debian\r\n* @hroncok / Fedora / RHEL\r\n* @mgorny / Gentoo\r\n* @danigm @mcepl / openSUSE\r\n* @AA-Turner @hugovk / CPython\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-125368\n* gh-125720\n* gh-125721\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/AA-Turner","@type":"Person","name":"AA-Turner"},"datePublished":"2024-10-10T18:49:24.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":9},"url":"https://github.com/125277/cpython/issues/125277"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:d277b69b-c802-5113-4539-151383bcb0c9 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | CC36:12FD57:370073:4AA9CB:6969D9EC |
| html-safe-nonce | 45a15a183c079a8d10a2bb0051910cd72b8debe70b12125e1fd8bf3ff2d6fde2 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDQzM2OjEyRkQ1NzozNzAwNzM6NEFBOUNCOjY5NjlEOUVDIiwidmlzaXRvcl9pZCI6IjYxNDg3NTExMDA1NjQwNjg4NDQiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | dea3706132447f5e4ec7c577ab8c084ee6b50f882046b49c837b928fde96f6c9 |
| hovercard-subject-tag | issue:2579590273 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/125277/issue_layout |
| twitter:image | https://opengraph.githubassets.com/b7001f249d86551d7c777ec4ffd5ce0b88318954dbff1adec48b7fa79ced862c/python/cpython/issues/125277 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/b7001f249d86551d7c777ec4ffd5ce0b88318954dbff1adec48b7fa79ced862c/python/cpython/issues/125277 |
| og:image:alt | Documentation Python 3.13 has been released, so I looked to review the minimum Sphinx version. Using the same survey as #109209 (comment) and #117928: Distro CPython Sphinx Debian 13 Trixie (testin... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | AA-Turner |
| hostname | github.com |
| expected-hostname | github.com |
| None | 7b32f1c7c4549428ee399213e8345494fc55b5637195d3fc5f493657579235e8 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/cpython git https://github.com/python/cpython.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 81598961 |
| octolytics-dimension-repository_nwo | python/cpython |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 81598961 |
| octolytics-dimension-repository_network_root_nwo | python/cpython |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | bdde15ad1b403e23b08bbd89b53fbe6bdf688cad |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width