-
Notifications
You must be signed in to change notification settings - Fork 24
How to create a new release
Alyssa Travitz edited this page Feb 26, 2025
·
12 revisions
First we create a release on GitHub, then we make a release on conda-forge. Once that process is done we can make the container images and single file installers.
Make the PR:
- Create a new release-prep branch corresponding to the version name, e.g.
release-prep-v1.2.0
. Note: please follow semantic versioning. - Check that all user-relevant updates are included in the
news/
rever.rst
files. You can backfill any additional items by making a new .rst, e.g.backfill.rst
- Run rever, e.g.
rever 1.2.0
. This will auto-commitdocs/CHANGELOG.md
and remove the.rst
files fromnews/
. - Verify that
docs/CHANGELOG.md
looks correct. - Make the PR and verify that CI/CD passes.
- Merge the PR into
main
.
- Create a release on Github
- The title should be the version, e.g.
v0.10.1
- Select "Choose Tag" and type in the new version, and click "Create new tag ... on publish"
- Then click "Generate Release Notes"
- Add the link to the openfe website changelog in the release notes.
- Add a few sentences to summarize the changes (for example, if there is a major API change, it can be helpful to add a section telling users how to migrate to new API).
Either wait for the conda-forge bot to pickup the new version (example) or create a pull request (example).
- Wait for the conda-forge release process to finish.
- Check here to see if the new version shows up.
- Once the version shows up, go here and click the "Run workflow" button, select the tag that you created for the release (on the tab next to branch) and then click "Run workflow" button.
- After the workflow finishes, the images should show up here
- Wait for the conda-forge release process to finish.
- Check here to see if the new version shows up.
- Once the version shows up, go here and click the "Run workflow" button, select the tag that you created for the release (on the tab next to branch) and then click "Run workflow" button.
Note: The workflow now should automatically upload the single file installer, so the next steps are not needed.
- Once the workflow finishes (both jobs need to finish) go to the "Summary" page for the workflow:
- Then scroll down to the "Artifacts" section (Note: Even if the Linux job finishes, the artifacts will not show up until both jobs are done)
- Download both artifacts and unzip them.
- Go back to the release you just made and click "Edit"
- Either drag the unzipped files into the box, or click the gray box to open a selection window for the files
-
Wait for the files to finish uploading, then click "Update Release"
-
Make a PR into the example notebooks repository to update the version used in
showcase/openfe_showcase.ipynb
and.binder/environment.yml