What's Changed

Improvements

• Loosen what keys can be cached in the sidebar by @Yann-P in #2500
• Declare color-scheme support and recommend light-dark() in the docs by @anandghegde in #2492

Fixes

• Fix shortening GitHub organization projects root links by @Junaid-PK in #2498
• Prevent unwanted renders of PST sidebar, even if disabled in configuration by @Yann-P in #2507
• Fix spacing between unnamed API return types by @haoran3160-afk in #2499

Maintenance

• Run npm audit; bump node version; add dep cooldown by @Yann-P in #2508
• Post-merge review for light-dark by @Yann-P in #2506

New Contributors

• @anandghegde made their first contribution in #2492
• @haoran3160-afk made their first contribution in #2499

Full Changelog: v0.22.0...v0.23.0rc0

What's Changed

Fixes

• fix a console error when pstAnnouncementUrl is undefined by @bollwyvl in #2481
• Fix primary sidebar collapse glitches on resize and expand by @consideRatio in #2482
• Fix behavior on X.Y stable for X.Y.Z releases by @larsoner in #2497

Improvements

• Add a configuration option for which templates to skip empty checks by @Cadair in #2477
• Mark the current page with aria-current in both navs by @opensource-joe in #2471

Maintenance

• Upgrade and fix precommit issues by @Yann-P in #2487
• Replace the unmaintained Graphviz setup action by @Junaid-PK in #2495

Dependencies

• Bump astral-sh/setup-uv from 10.0.0 to 10.0.1 by @dependabot[bot] in #2478
• Bump postcss-selector-parser by @dependabot[bot] in #2479
• Bump browserslist from 4.28.1 to 4.28.8 by @dependabot[bot] in #2480
• Bump hynek/build-and-inspect-python-package from 2.18.0 to 3.0.1 by @dependabot[bot] in #2461
• Bump svgo from 4.0.2 to 4.1.0 by @dependabot[bot] in #2485
• Bump js-yaml from 4.3.1 to 4.3.2 by @dependabot[bot] in #2486
• Bump scientific-python/upload-nightly-action from 0.6.4 to 0.6.5 by @dependabot[bot] in #2488

New Contributors

• @opensource-joe made their first contribution in #2471
• @Junaid-PK made their first contribution in #2495

Full Changelog: v0.21.0...v0.22.0

What's Changed

Breaking

None

Improvements

• Add a configuration option for which templates to skip empty checks by @Cadair in #2477
• Mark the current page with aria-current in both navs by @opensource-joe in #2471

Fixes

• Fix primary sidebar collapse glitches on resize and expand by @consideRatio in #2482
• fix a console error when pstAnnouncementUrl is undefined by @bollwyvl in #2481

Dependencies

• Bump astral-sh/setup-uv from 10.0.0 to 10.0.1 by @dependabot[bot] in #2478
• Bump postcss-selector-parser by @dependabot[bot] in #2479
• Bump browserslist from 4.28.1 to 4.28.8 by @dependabot[bot] in #2480
• Bump hynek/build-and-inspect-python-package from 2.18.0 to 3.0.1 by @dependabot[bot] in #2461
• Bump svgo from 4.0.2 to 4.1.0 by @dependabot[bot] in #2485
• Bump js-yaml from 4.3.1 to 4.3.2 by @dependabot[bot] in #2486

New Contributors

• @opensource-joe made their first contribution in #2471

Full Changelog: v0.21.0...v0.22.0rc0

What's Changed

Breaking

None.

Fixes

• Fix navbar rendering for special pages in toctree by @medmunds in #2447
• Fix empty search page when search_as_you_type and dirhtml is used by @consideRatio in #2448
• Tox run a11y-tests correctly defaults to chromium ; add doc to run a single test. by @arturict in #2445
• fix: correct typo in source by @TheGreatApollyon in #2459
• fix: don't share sidebars between pages with non-flat output URIs by @larsoner in #2469
• Prevent "Back to Top" button from being cropped on firefox/android by @Yann-P in #2442

Improvements

• Add helper release script to bump version by @Yann-P in #2438
• Add GALACTIC documentation link to gallery by @chdemko in #2443
• Avoid redundant processing when collapse_navigation=False by @larsoner in #2449
• refactor: drop user-select rule superseded by Sphinx's basic.css by @larsoner in #2464

Dependencies

• Bump astral-sh/setup-uv from 8.2.0 to 8.3.2 by @dependabot[bot] in #2444
• Bump svgo from 4.0.1 to 4.0.2 by @dependabot[bot] in #2452
• Bump immutable from 4.3.8 to 4.3.9 by @dependabot[bot] in #2453
• Bump pypa/gh-action-pypi-publish from 1.14.0 to 1.14.1 by @dependabot[bot] in #2455
• Bump astral-sh/setup-uv from 8.3.2 to 9.0.0 by @dependabot[bot] in #2454
• Bump actions/checkout from 7.0.0 to 7.0.1 by @dependabot[bot] in #2456
• Bump postcss from 8.5.8 to 8.5.23 by @dependabot[bot] in #2458
• Bump actions/setup-python from 6.3.0 to 7.0.0 by @dependabot[bot] in #2457
• Bump pypa/gh-action-pypi-publish from 1.14.1 to 1.14.2 by @dependabot[bot] in #2460
• Bump js-yaml from 4.2.0 to 4.3.1 by @dependabot[bot] in #2463
• Bump py-cov-action/python-coverage-comment-action from 4.1 to 4.3 by @dependabot[bot] in #2467
• Bump astral-sh/setup-uv from 9.0.0 to 10.0.0 by @dependabot[bot] in #2468

New Contributors

• @chdemko made their first contribution in #2443
• @medmunds made their first contribution in #2447
• @consideRatio made their first contribution in #2448
• @arturict made their first contribution in #2445
• @TheGreatApollyon made their first contribution in #2459

Full Changelog: v0.20.0...v0.21.0

What's Changed

🔴 Breaking

• Drop Sphinx <= 8.1, Python <= 3.10 by @Yann-P in #2412

Fixes

• Fix relative json_url on home page when using dirhtml builder by @Yann-P in #2436
• Fix content of sidebar shifting vertically on page load by @Yann-P in #2415
• Fix broken link in our example gallery and replace it with another one by @Yann-P in #2430

Internal tooling

• Unpin internal actions by @Yann-P in #2427
• Fix incorrect tox env name in prerelease docs build step by @yyccPhil in #2421

Dependencies

• Bump internal actions ; Bump pyupgrade options to 3.7+ -> 3.11+ by @Yann-P in #2416
• Update deps (was incorrect) by @Carreau in #2417
• Bump ws from 7.5.10 to 7.5.11 by @dependabot[bot] in #2419
• Bump js-yaml from 4.1.1 to 4.2.0 by @dependabot[bot] in #2420
• Bump actions/checkout from 6.0.3 to 7.0.0 by @dependabot[bot] in #2423
• Bump internal actions by @Yann-P in #2426
• fix: stabilize Read the Docs Ubuntu image by @sanmaxdev in #2429
• Bump actions/setup-python from 6.2.0 to 6.3.0 by @dependabot[bot] in #2431
• Bump actions/cache from 5.0.5 to 6.1.0 by @dependabot[bot] in #2433
• Bump py-cov-action/python-coverage-comment-action from 3.41 to 4.1 by @dependabot[bot] in #2432
• [pre-commit.ci] pre-commit autoupdate hooks by @pre-commit-ci[bot] in #2435

New Contributors

• @yyccPhil made their first contribution in #2421
• @sanmaxdev made their first contribution in #2429

Full Changelog: v0.19.0...v0.20.0

What's Changed

• Bump pydata/pydata-sphinx-theme/.github/workflows/CI.yml from 178df7a to 047227a by @dependabot[bot] in #2398
• Bump pydata/pydata-sphinx-theme from 178df7a to 047227a by @dependabot[bot] in #2397
• Bump hynek/build-and-inspect-python-package from 2.17.0 to 2.18.0 by @dependabot[bot] in #2396
• Bump pydata/pydata-sphinx-theme/.github/workflows/docs.yml from 178df7a to 047227a by @dependabot[bot] in #2395
• Docs update Font Awesome links by @hntk03 in #2399
• [pre-commit.ci] pre-commit autoupdate hooks by @pre-commit-ci[bot] in #2347
• [pre-commit.ci] pre-commit autoupdate hooks by @pre-commit-ci[bot] in #2401
• Fix code coverage workflow by @Yann-P in #2393
• Bump actions/checkout from 6.0.2 to 6.0.3 by @dependabot[bot] in #2406
• Bump astral-sh/setup-uv from 8.1.0 to 8.2.0 by @dependabot[bot] in #2407
• Fix vertical scrollbar in math container by @hntk03 in #2404
• [css] De-jumble header items at intermediate widths :) by @sneakers-the-rat in #1784
• Fix gettext builder by @Yann-P in #2403
• Bump 0.18.0 -> 0.19.0rc0 by @Yann-P in #2410
• fix: configure defaults for Google Analytics before loading script by @tswast in #2369
• Bump 0.19.0rc0 -> 0.19.0 by @Yann-P in #2414

New Contributors

• @sneakers-the-rat made their first contribution in #1784

Full Changelog: v0.18.0...v0.19.0

Fixes

• De-jumble header items at intermediate widths :) by @sneakers-the-rat in #1784
• Fix vertical scrollbar in math container by @hntk03 in #2404
• Fix gettext builder by @Yann-P in #2403

Internal tooling, CI

• Docs update Font Awesome links by @hntk03 in #2399
• Fix code coverage workflow by @Yann-P in #2393

Dependencies

• Bump pydata/pydata-sphinx-theme/.github/workflows/CI.yml from 178df7a to 047227a by @dependabot[bot] in #2398
• Bump pydata/pydata-sphinx-theme from 178df7a to 047227a by @dependabot[bot] in #2397
• Bump hynek/build-and-inspect-python-package from 2.17.0 to 2.18.0 by @dependabot[bot] in #2396
• Bump pydata/pydata-sphinx-theme/.github/workflows/docs.yml from 178df7a to 047227a by @dependabot[bot] in #2395
• [pre-commit.ci] pre-commit autoupdate hooks by @pre-commit-ci[bot] in #2347
• [pre-commit.ci] pre-commit autoupdate hooks by @pre-commit-ci[bot] in #2401
• Bump actions/checkout from 6.0.2 to 6.0.3 by @dependabot[bot] in #2406
• Bump astral-sh/setup-uv from 8.1.0 to 8.2.0 by @dependabot[bot] in #2407

Acknowledgements

• Thanks @sneakers-the-rat and @timhoffm for working on the medium size layout
• Thanks @hntk03 for your sustained involvement across several releases

New Contributors

• @sneakers-the-rat made their first contribution in #1784

Full Changelog: v0.18.0...v0.19.0rc0

Breaking

• Drop support for sphinx 7, minimal requirement now 8 by @Yann-P in #2366

Improvements

• feat(theme): add sticky_version_warning_banner option by @tmchow in #2372 (revised in #2385, now sticky_banners)
• feat: replace theme switcher with dropdown by @hntk03 in #2340
• Consistent linting and formatting across CI and local environment by @Yann-P in #2368
• Add distinctive style for menuselection, based on guilabel by @stevepiercy in #2367
• Update to FontAwesome v7 by @agriyakhetarpal in #2370
• Add documentation on how users can override the FontAwesome version by @agriyakhetarpal in #2373

Bugs

• Fix sidebar top being cut off on mobile browsers by @hntk03 in #2363
• Docs update PyTorch logo URL by @hntk03 in #2374
• Fix theme dropdown menu going offscreen by @hntk03 in #2387
• Fix the stickiness of the version warning banner, and rename the config option to sticky_banners by @agriyakhetarpal in #2385

Dependencies

• Bump pydata/pydata-sphinx-theme from e8db643 to a4986fa by @dependabot[bot] in #2362
• Bump pypa/gh-action-pypi-publish from 1.13.0 to 1.14.0 by @dependabot[bot] in #2371
• Bump astral-sh/setup-uv from 7.3.0 to 8.1.0 by @dependabot[bot] in #2375
• Bump actions/upload-artifact from 7.0.0 to 7.0.1 by @dependabot[bot] in #2361
• Bump scientific-python/upload-nightly-action from 0.6.3 to 0.6.4 by @dependabot[bot] in #2359
• Bump pydata/pydata-sphinx-theme/.github/workflows/docs.yml from 0.17.0 to 0.17.1 by @dependabot[bot] in #2360
• Bump actions/cache from 5.0.3 to 5.0.5 by @dependabot[bot] in #2391
• Bump py-cov-action/python-coverage-comment-action from 3.40 to 3.41 by @dependabot[bot] in #2390
• Bump actions/github-script from 8.0.0 to 9.0.0 by @dependabot[bot] in #2388

New Contributors

• @agriyakhetarpal made their first contribution in #2370

Full Changelog: v0.17.1...v0.18.0

What's Changed

• Fix theme dropdown menu going offscreen by @hntk03 in #2387
• Fix the stickiness of the version warning banner, and rename the config option to sticky_banners by @agriyakhetarpal in #2385

• Bump actions/cache from 5.0.3 to 5.0.5 by @dependabot[bot] in #2391
• Bump py-cov-action/python-coverage-comment-action from 3.40 to 3.41 by @dependabot[bot] in #2390
• Bump actions/github-script from 8.0.0 to 9.0.0 by @dependabot[bot] in #2388

Full Changelog: v0.18.0rc1...v0.18.0rc2

What's Changed

• Update internal CI action pin for tests by @Yann-P in #2382

Full Changelog: v0.18.0rc0...v0.18.0rc1