cheatsheets icon indicating copy to clipboard operation
cheatsheets copied to clipboard

Bump pydata sphinx theme version

Open dstansby opened this issue 4 months ago • 3 comments

This bumps the pydata-sphinx-theme version to the same one currently being used on the Matplotlib docs (0.15.x).

dstansby avatar Aug 23 '25 09:08 dstansby

Why are we pinning to 0.15.x? Are there any known incompatibilities either 0.16.x?

Also, more generally, what is our update strategy? When do we plan to update and which checks should be performed?

timhoffm avatar Aug 23 '25 12:08 timhoffm

My thinking was to be consistent with matplotlib/matplotlib, which is pinned to 0.15.x at the moment.

In terms of a update strategy, I think we should revive https://github.com/matplotlib/mpl-sphinx-theme/pull/84 and put a pydata-sphinx-theme pin in the theme itself, which would avoid having to do this pinning across all the website repositories. Then we can set up dependabot in mpl-sphinx-theme to handle bumping the pydata version.

dstansby avatar Aug 24 '25 08:08 dstansby

I've opened https://github.com/matplotlib/mpl-sphinx-theme/pull/106 to move the pinning of pydata-sphinx-theme to mpl-sphinx-theme.

dstansby avatar Aug 24 '25 08:08 dstansby