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. Update version in plover/, and stage the change git add plover/

  2. Install towncrier (pip install towncrier) and update towncrier.

  3. Review the staged changes, check all news fragments in news.d were properly handled (merged into and removed by towncrier).

  4. Commit: git commit -m "release $(./ --version)"

  5. Tag the release: git tag -m "$(git log -1 --pretty='format:%B')" "v$(./ --version)"

  6. Push to Github: git push --follow-tags origin