Release 0.16.0

[Carreau]

I think with the recent sphinx 8 fixes it woudl be good to make a new release potentially dropping older shinx. Here are the list of things to do for a new release.

Double check for quality-control

• There are no open issues with a impact: block-release label

Prepare the codebase for a new version

• Bump __version__ in __init__.py
• Update our version switcher .json file with the new version
• Make a release commit: git commit -m 'bump: 0.1.9 → 0.2.0'
• Push the RLS commit git push upstream main
• If a release candidate is needed, tick this box when we're now ready for a full release.

Make the release

• Start a new GitHub release
  • Call the release the current version, e.g. v0.2.0
  • In the Choose a Tag: dropdown, type in the release name (e.g., v0.2.0) and click "Create new tag"
  • In the Target: dropdown, pin it to the release commit that you've just pushed.
  • Generate the automatic release notes, eventually manually specify the previous version (useful when several release candidate have been made)
• Confirm that the release completed
  • The publish github action job has completed successfully in the actions tab.
  • The PyPI version is updated
• Hide the previous patch version build in the RDT interface if needed.
• Celebrate, you're done!

[Elodie-Praxinos]

Just to say I'd really like a version compatible with Sphinx 8 too!

[Carreau]

I don't think it's incompatible, did you encounter any specific errors ?

[Elodie-Praxinos]

Yes:

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. myst-parser 0.17.0 requires docutils<0.18,>=0.15, but you have docutils 0.21.2 which is incompatible. myst-parser 0.17.0 requires sphinx<5,>=3.1, but you have sphinx 8.0.2 which is incompatible.

[drammock]

Please try updating myst parser. Current stable release is 4.0.0 and you seem to have 0.17.0

[Elodie-Praxinos]

Indeed, that helped. Now I got other issues probably coming from the fact I am already using a different theme (sphinx-material).

pickling environment... WARNING: cannot cache unpickable configuration value: 'html_context' (because it contains a function, class, or module object) [config.cache]
done
checking consistency... done
preparing documents... done
copying assets... 
copying static files... done
copying extra files... done
copying assets: done
writing output... [  1%] 
Extension error (pydata_sphinx_theme):
Handler <function update_and_remove_templates at 0x1131fce50> for event 'html-page-context' threw an exception (exception: 'logo-text.html' not found in ['/Users/elodie/Documents/github/Doc/source/_templates', '/Users/elodie/Library/Python/3.10/lib/python/site-packages/pydata_sphinx_theme/theme/pydata_sphinx_theme/components', '/Users/elodie/Library/Python/3.10/lib/python/site-packages/pydata_sphinx_theme/theme/pydata_sphinx_theme', '/Users/elodie/Library/Python/3.10/lib/python/site-packages/sphinx/themes/basic'])

[dylanh724]

Related: #1938

[dopplershift]

MetPy's docs are building fine with sphinx 8.0.2 and pydata-sphinx-theme 0.15.4 (myst-parser 4.0.0).

[dbitouze]

MetPy's docs are building fine with sphinx 8.0.2 and pydata-sphinx-theme 0.15.4 (myst-parser 4.0.0).

The same applies to the French LaTeX FAQ 😊

[drammock]

@trallard @Carreau seems like we're close to being ready for another release? Only listed blockers are #1982 (which looks to be basically done?) and #1938 (which I think can be closed as completed given the comments above). #1992 made me realize some nice improvements still aren't in the hands of stable users.

[trallard]

We should be able to make a release whenever (#1982 is now merged), and we have been testing against Sphinx 8, and I have not spotted anything amiss. Neither of our CIs has so it is up to you @drammock, shall we cut a pre-release?

[drammock]

shall we cut a pre-release?

Yes I think so. I probably can't do it until next Wednesday so if one of you has time sooner then go for it

[trallard]

I shall be able to do this on Monday.

[trallard]

The pre-release is now out https://pypi.org/project/pydata-sphinx-theme/0.16.0rc0/
This can be installed with pip install pydata-sphinx-theme==0.16.0rc0 --pre

There is also a discussion opened #1997