To release a new stable version of syntheseus
one needs to complete the following steps:
- Create a PR editing the
CHANGELOG.md
analogous to #88 (note how the changelog has to be modified in three places). - Run the "Release Stable Version" workflow, providing the version number as argument (use the
x.y.z
format without the leading "v"; the workflow will prepend it wherever necessary). Make sure the branch is set tomain
. If this step does not work as intended the tag can always be deleted manually, while the changes to the docs can be reverted by removing a commit from thegh-pages
branch (requires a force push). - Create a GitHub Release from the newly created tag. Set the name to
syntheseus x.y.z
. The description should be the list of changes copied from the changelog (example here). Consider including a short description before the list of changes to describe the main gist of the release. - Release a new version to PyPI (e.g. by following these instructions). Consider publishing to Test PyPI first to verify that the README renders correctly.