Release

Contents

Release#

Releases are automatically archived on Zenodo. After making a release, a DOI is made available by Zenodo which can be used in publications.

Useful links:

Prepare#

  • [ ] Update list of authors in CITATION.cff, if necessary

  • [ ] Initiate (no need to create one yourself) a Conda-Forge PR:

    • [ ] Create an issue + branch for preparing the release

    • [ ] Create a zip and determine sha256:

      cd $HOME/tmp
      prepare_lue_release.sh kordejong 0.3.10 gh861
      
    • [ ] Upload zip to https://lue.computationalgeography.org/download/lue-<version>.tar.bz2

  • [ ] Wait for PR to appear on conda-forge/lue-feedstock . This can take hours.

  • [ ] Checkout the PR’s branch and update the recipe files:

    • [ ] Verify the sha256 is the same as the one found above

    • [ ] Verify the build number is correct (zero for new version, bumped if not)

    • [ ] Compare files with the ones in LUE’s environment/conda directory. Harmonize.

    • [ ] Update project’s description if needed (feedstock’s README.md)

    • [ ] Verify @conda-forge-admin, please rerender has been run

    • [ ] Do whatever it takes to make the builds succeed. In case the sources must be updated, an update of the hash in the feedstock’s meta.yaml will trigger a rebuild of the packages

Release#

  • [ ] Draft a release on GitHub. We do not use the letter v to prefix version numbers.

    • [ ] Create a new zip with the same name and determine sha256:

      cd $HOME/tmp
      prepare_lue_release.sh computationalgeography 0.3.10 master
      
    • [ ] Upload zip to https://lue.computationalgeography.org/download/lue-<version>.tar.bz2

    • [ ] Update the recipe files in the PR:

      • [ ] Replace the sha256 with one just found

    • [ ] Wait for all builds to succeed

  • [ ] Merge Conda-Forge PR

  • [ ] Postprocess release:

    • [ ] Bump version number in:

      • [ ] The main CMakeLists.txt

      • [ ] environment/conda/meta.yaml

    • [ ] Update the Releases page in the documentation to contain a section for the new version

    • [ ] Write blog post about the release

    • [ ] Post about the release on Mastodon

    • [ ] Update tutorial repo

      • [ ] Bump LUE version number in {main,develop}/environment/configuration/conda_environment.yml

      • [ ] Verify actions still succeed, or fix things until they do