Release Workflow
This skill guides you through the process of releasing a new version of the project.
Workflow
- •
Preparation
- •Ensure the git working directory is clean:
git status. - •Pull the latest changes:
git pull origin main.
- •Ensure the git working directory is clean:
- •
Version Bump
- •Update the
versionfield in the rootCargo.toml. - •Verify
Cargo.lockis updated (e.g., runcargo checkto trigger update).
- •Update the
- •
Verification
- •Run tests:
cargo test -q.
- •Run tests:
- •
Changelog
- •Update
CHANGELOG.md. - •Ensure there is an entry for the new version with the current date:
## [vX.Y.Z] - YYYY-MM-DD. - •Ensure content adheres to Keep a Changelog.
- •Update
- •
Commit
- •Stage changes:
git add Cargo.toml Cargo.lock CHANGELOG.md. - •Commit with message:
git commit -m "Release vX.Y.Z".
- •Stage changes:
- •
Tagging
- •Create a git tag with the 'v' prefix:
git tag vX.Y.Z. - •Important: The release workflow depends on the
vprefix (e.g.,v0.1.4).
- •Create a git tag with the 'v' prefix:
- •
Push
- •Push the commit:
git push origin main. - •Push the tag:
git push origin vX.Y.Z.
- •Push the commit:
- •
Completion
- •The GitHub Actions workflow will automatically create the release and publish artifacts.