Releasing
Follow these steps for every release. The performance step is part of the release: the Performance page must describe the version you ship.
- Changelog. Put the changes under the new version in
CHANGELOG.md. Say the database version and any config change. - Tests.sh
go vet ./... go test -race ./... python3 -I spec/genvectors.py | diff - spec/vectors.json - Build with the version number.sh
V=0.2.0 CGO_ENABLED=0 go build -ldflags "-X main.version=$V" -o /tmp/tm ./cmd/tallymoth CGO_ENABLED=0 go build -o /tmp/bench ./tools/bench docker build --build-arg VERSION=$V -f Dockerfile -t tallymoth:bench . - Run the benchmarks on a machine with nothing else running.sh
/tmp/bench -bin /tmp/tm -docker tallymoth:bench -docs docs/performance.md tools/bench/matrix.sh /tmp/tm /tmp/bench /var/tmp/bench-data /var/tmp/bench-out /tmp/bench -report /var/tmp/bench-out -docs docs/performance.md - Read the change in
docs/performance.md. Compare it with the last release. A number that moved more than about 10% needs a reason in the changelog, or a fix. Check that no row saystimed out,Killedor shows errors unless that is the point of the row. - Update other places that quote numbers: the landing page, Docker and the README.
- Commit and push to
main. Thedocsworkflow publishes the site. - Tag.
git tag v$V && git push origin v$V. Thereleaseworkflow then publishes the downloads (Linux, macOS and Windows; amd64 and arm64) as a GitHub release, and the Docker imageghcr.io/javedh-dev/tallymothfor amd64 and arm64.
Why benchmarks are part of a release
A database that gets a little slower with each change is only noticed when a dashboard starts timing out. The same numbers for every release make the trend visible, and give users something to plan with. The History table on the Performance page is that record.
Version numbers
- Patch: fixes, no config or database change.
- Minor: new features and optional fields, maybe a database upgrade. Old config files keep working.
- Major (
/v2, or configversion: 2): a breaking change, announced in the changelog before release. See Architecture.