CONTRIBUTING.md

Release guide

Preparation

Ensure that:

1. All PRs to be included in the release have been merged.
2. CHANGELOG.md details all changes relevant to end users and that PR links are correct.
3. The release date in CHANGELOG.md is correct.
4. The VERSION in maze.rb is correct for the release
5. The Gemfile.lock is up-to-date (run bundle install)
6. The last merge to master (or relevant major version branch) built and ran all tests successfully.

Performing the release

1. On Github, 'Draft a new release':
   1. Tag version - of the form v5.0.1
   2. Target - generally master unless the release is a minor/patch for a previous major version for which we have a branch.
   3. Release title - as the Tag version
   4. Description - copy directly from CHANGLEOG.md, ensuring that the formatting looks correct in the preview.

After the release

1. Ensure that any integration branches that exist are brought up-to-date.