Before releasing, check:

Address any failures before releasing.

  1. Create a new branch:

    $ git checkout -b release/X.Y.Z.
  2. Edit doc/whatsnew.rst. Comment the heading “Next release”, then insert another heading below it, at the same level, with the version number and date. Commit this change with a message like:

    $ git commit -m "Mark vX.Y.Z in doc/whatsnew".
  3. Tag the release candidate version, i.e. with a rcN suffix, and push:

    $ git tag vX.Y.Zrc1
    $ git push --tags origin release/X.Y.Z
  4. Open a PR with the title “Release vX.Y.Z” using this branch. Check:

    Address any warnings or errors that appear. If needed, make (an) additional commit(s) and go back to step (3), incrementing the rc number.

  5. Merge the PR using the ‘rebase and merge’ method.

  6. (optional) Switch back to the main branch; tag the release itself (without an rc number), and push:

    $ git checkout main
    $ git pull --fast-forward
    $ git tag vX.Y.Z
    $ git push --tags origin main

    This step (but not step (3)) can also be performed directly on GitHub; see (7), next.

  7. Visit and mark the new release: either using the pushed tag from (6), or by creating the tag and release simultaneously.

  8. Check at and that the distributions are published.