*******************
 Release procedure
*******************

* Check that the version number in setup.py and in docs/source/conf.py
  is correct.

* Check that the changelog is up to date.

* Generate the distribution files::

     $ python3 setup.py sdist bdist_wheel

* Upload ::

     $ twine upload -s dist/*

* Tag the uploaded version::

     $ git tag -s v$VERSION
     $ git push
     $ git push --tags

  for the tag content use something like::

     Version $VERSION

     * contents
     * of the relevant
     * changelog