Description of the release procedure
------------------------------------

1. Merge gitcral and github

    git remote add github git@github.com:musevlt/mpdaf.git
    git fetch github
    git merge github/master
    in case of conflict: git add + git commit

2. Update changelog, update version number and date (CHANGELOG)

3. Run tests and build documentation to make sure that everything is ok.

4. Commit and push.

    git push origin master
    git push github master

5. When CI and readthedocs are happy, tag the version and push.  The package
   version is set automatically from the git tag thanks to setuptools_scm.

   git push --tags
   git push github <tag_name>

6. Activate the new version on https://readthedocs.org/projects/mpdaf/versions/ (Edit/Active)

7. Check that the release workflow is running on GitHub and that wheels are
   uploaded to PyPI.

   https://github.com/musevlt/mpdaf/actions/workflows/publish.yml
   https://pypi.org/project/mpdaf/

8. Prepare the next version: add new version header in the changelog.
