Releasing

Before releasing, check:

Address any failures before releasing.

  1. 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. Make a commit with a message like “Mark vX.Y.Z in doc/whatsnew”.

  2. Tag the release candidate version, i.e. with a rcN suffix, and push:

    $ git tag v1.2.3rc1
    $ git push --tags origin master
    
  3. Check:

    Address any warnings or errors that appear. If needed, make a new commit and go back to step (2), incrementing the rc number.

  4. (optional) Tag the release itself and push:

    $ git tag v1.2.3
    $ git push --tags origin master
    

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

  5. Visit https://github.com/khaeru/genno/releases and mark the new release: either using the pushed tag from (4), or by creating the tag and release simultaneously.

  6. Check at https://github.com/khaeru/genno/actions?query=workflow:publish and https://pypi.org/project/genno/ that the distributions are published.