diff --git a/.changelog/841.trivial.md b/.changelog/841.trivial.md new file mode 100644 index 000000000..e69de29bb diff --git a/docs/release-process.md b/docs/release-process.md index fadb35530..567bd9293 100644 --- a/docs/release-process.md +++ b/docs/release-process.md @@ -2,19 +2,39 @@ The following steps are needed to create a release. -Create a tag on the commit that should be released: +1. **Prepare for Release** + - Create a new branch for the release and generate the changelog: -```bash -export VERSION=v0.0.1 -git tag --sign --message="Version ${VERSION}" "${VERSION}" -``` + ```bash + export VERSION=v0.0.1 + git checkout -b /release-${VERSION} + make changelog + ``` -Push the tag upstream: +2. **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.py` to match the release version. + - Add a `Deployment Notes` section to the changelog, if relevant or needed. -```bash -git push origin "${VERSION}" -``` +3. **Create and Merge a Pull Request** + - Create a pull request from the `/release-${VERSION}` branch. + - Get the pull request reviewed and merged into `main`. -This will trigger the `release` GitHub Action that will create and publish a -release, together with the changelog with changes since the previous release. -Commit messages are used to generate the changelog. +4. **Pull the Latest Changes** + - Switch to the `main` branch and pull the latest changes: + + ```bash + git checkout main + git pull + ``` + +5. **Create the Release Tag** + - Run the following command to create the release tag: + + ```bash + make release-tag + ``` + + - This will trigger the `release` GitHub Action to create and publish the + release, including the changelog with changes since the previous release.