Release checklist - pydata/pydata-sphinx-theme Wiki

Release instructions

The pydata-sphinx-theme follows semantic version numbers.

This page contains the steps to make a release and some helpful resources to get you started.

Create an issue and copy/paste the steps below to release a new version. Close the issue when it is done.

**Double check for quality-control**

- [ ] There are no more open issues in [the release milestone](
- [ ] There are no [open issues with a `block-release` label](

**Prepare the codebase for a new version**

- [ ] Bump `__version__` in [````]([^semantic-version]
- [ ] Update our version switcher `.json` file with the new version
- [ ] Make a release commit: ``git commit -m 'RLS: v0.2.0'``
- [ ] Push the RLS commit ``git push upstream master``

**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.
- [ ] Add release notes in the field below (if it's a minor/major version bump)[^github-activity]
- [ ] Confirm that [the `publish` github action job]( has completed successfully in the [actions tab](
- [ ] Confirm that [the PyPI version is updated](
- [ ] Celebrate, you're done!

[^semantic-version]: Use [semantic versioning]( to decide whether it's a major, minor, or patch bump. Before we have released `1.0`, treat minor versions as breaking releases, and patch versions as feature / patch releases.

[^github-activity]: If you wish, use [`github-activity` to generate a changelog](, eg `github-activity pydata/pydata-sphinx-theme --since v0.2.2 --until v0.3.0`.