docs: bump all documentation dependencies

[onerandomusername]

What Changed

Bump all documentation dependencies, restrict them to python 3.11, bump the entire documentation to 3.11 too.

Changelogs

• sphinx
  • https://www.sphinx-doc.org/en/master/changes/8.2.html
  • https://www.sphinx-doc.org/en/master/changes/8.1.html
  • https://www.sphinx-doc.org/en/master/changes/8.0.html
  • https://www.sphinx-doc.org/en/master/changes/7.4.html
  • https://www.sphinx-doc.org/en/master/changes/7.3.html
  • https://www.sphinx-doc.org/en/master/changes/7.2.html
  • https://www.sphinx-doc.org/en/master/changes/7.1.html
• sphinx-autobuild
  • sphinx-doc/sphinx-autobuild@2021.03.14...2025.08.25
• sphinx-hoverxref
  • readthedocs/sphinx-hoverxref@1.3.0...1.4.2
• sphinx-notfound-page
  • readthedocs/sphinx-notfound-page@0.8.2...1.1.0
• sphinxcontrib-towncrier
  • https://github.com/sphinx-contrib/sphinxcontrib-towncrier/releases/tag/v0.5.0a0
  • https://github.com/sphinx-contrib/sphinxcontrib-towncrier/releases/tag/v0.4.0a0
• sphinxcontrib-trio
  • no updates
• towncrier
  • https://towncrier.readthedocs.io/en/stable/release-notes.html 23.6.0 -> 25.8.0

Deprecations

sphinx-hoverxref uses some interfaces removed in sphinx 9.0. However, sphinx-hoverxref is it itself deprecated, so we should drop it anyhow.

Depends on

#1341, which limits docs to only being typechecked on the version it runs on.

[shiftinv]

Are you planning on dropping hoverxref in this or in a separate PR?

[onerandomusername]

Are you planning on dropping hoverxref in this or in a separate PR?

Planning to drop hoverxref on another PR.

This one is also blocked by needing to figure out pyright 3.8-3.10 overrides

[read-the-docs-community]

Documentation build overview

📚 disnake | 🛠️ Build #32838539 | 📁 Comparing 95ebd03 against latest (55392d3)

  🔍 Preview build  

71 files changed · ± 71 modified

± Modified

• 404.html
• api.html
• discord.html
• faq.html
• index.html
• intents.html
• intro.html
• logging.html
• migrating.html
• migrating_to_async.html
• and 61 more...

[shiftinv]

Looks good overall! A couple things:

• Could we just filter the sphinx 9.0 deprecation warning for the time being, until we replace hoverxref properly?
• Low priority, but this info log is pretty noisy, could potentially filter it
• Similarly, Converting `source_suffix = '.rst'` to `source_suffix = {'.rst': 'restructuredtext'}`. - we could update this in conf.py as well. It's always been doing this conversion, but the log was only added recently
• On subsequent autobuild runs, I'm getting Aborted attempted copy from rendered template _templates/api_redirect.js_t [...]. As far as I can tell, we now need a force=True here:

  disnake/docs/extensions/redirects.py

  Lines 40 to 44 in e93670d

  	copy_asset_file(
  	SCRIPT_PATH,
  	str(Path(app.outdir, "_static", "api_redirect.js")),
  	context=context,
  	)

  • Somewhat related, since the copy_redirect_script hook here takes Exception instead of Exception | None, type checkers consider most of that function dead code

[shiftinv]

A couple more things I noticed:

• Sphinx added the classic purple coloring to visited links, the contrast with the documentation's background color is awful (contrast ratio of 1.05):
  
  I think the best solution would be to override that selector and remove the highlight, visited link tracking for a documentation website seems fairly pointless to me anyway.
• Maybe it's just the PR preview build, but search is pretty broken outside of the indexed results; it requests pages like https://disnake--1325.org.readthedocs.build/en/1325/undefinedext/tasks/index.html, which obviously don't resolve. Haven't really investigated why, yet.
  • edit: data-content_root is missing on the root element, see [ANNOUNCEMENT] Potential Breaking Changes in Sphinx 7.2.x sphinx-doc/sphinx#11608 (comment)
• Redirects from the old api.html#ref to api/page.html#ref are broken, since URL_ROOT no longer exists (see previous point). We should use document.documentElement.dataset.content_root instead.

(also, thanks for including links to all the changelogs <3)