The following steps are needed to create a release.
-
Prepare for Release
-
Create a new branch for the release and generate the changelog:
export VERSION=v0.0.1 git checkout -b <user>/release-${VERSION} make changelog
-
-
Review and Update the Changelog
- Review the generated changelog and make updates if necessary.
- If needed (e.g., for a minor release), manually update the version in
.punch_version.pyto match the release version. - Add a
Deployment Notessection to the changelog, if relevant or needed.
-
Create and Merge a Pull Request
- Create a pull request from the
<user>/release-${VERSION}branch. - Get the pull request reviewed and merged into
main.
- Create a pull request from the
-
Pull the Latest Changes
-
Switch to the
mainbranch and pull the latest changes:git checkout main git pull
-
-
Create the Release Tag
-
Run the following command to create the release tag:
make release-tag
-
This will trigger the
releaseGitHub Action to create and publish the release, including the changelog with changes since the previous release.
-