Home

Where to release

• GitHub
• PyPI (picks up automatically from GitHub Release)
• conda-forge (picks up automatically from PyPI)
• Zenodo (picks up automatically from GitHub Release)

How to release on GitHub

1. Grab latest code from master
2. Grab all the tags from this repo
3. Make sure you are on the branch that you intend to release from
4. Check git status (must be clean) and git log (must contain correct history)
5. Finalize release date on change log, add, and commit it.
6. git clean -xdf
7. git tag -s "X.Y.Z" -m "Tagging version X.Y.Z" (replace X.Y.Z with real version number)
8. git push <remote> X.Y.Z (replace <remote> with remote name that points to this repo)
9. Add new change log entry for next release, add, and commit it.
10. git push <remote> master
11. git checkout stable
12. git reset --hard <version>
13. git push <remote> stable --force
14. Edit release tag on GitHub to add change log and publish release.

How to release on PyPI

Check the logs under Actions. This should be done automatically when a GitHub Release is made. If successful, you will see it on https://pypi.org/project/stginga/ .

Other release outlets

• Wait for a notification from conda-forge feedstock, review its PR, fix (if needed), and merge.
• Check Zenodo page (https://doi.org/10.5281/zenodo.4927189) to make sure GitHub webhook pushed the release there.
• Check https://readthedocs.org/projects/stginga/builds/