# Release Process

Version numbers:

- official release: `{major}.{minor}.{patch}` (e.g. `2.2.1`, `3.1.0`, `4.0.0`...)
- pre-release: `{major}.{minor}.{patch}.{dev|rc}{devel}` (e.g. `4.0.0.dev7`, `4.0.0rc1`, ...)


Steps to cut a new release (from a clean checkout of `master`):

1. Run `tox -e release_prepare {NEW_VERSION_NUMBER}`.
2. Review the staged changes, check all news fragments in `news.d` were
   properly handled (merged into `NEWS.md` and removed by towncrier).
3. Run `tox -e release_finalize`
4. Follow the last command instructions, and push to GitHub.