Creating a release
==================

This document is documentation intednded for maintainers of Barrier.
It documents the release process of Barrier.

Step 1: Setup environment variables
-----------------------------------

Setup the following environment variable that will be used throughout the rest of the steps.

    export VERSION=X.Y.Z

Step 2: Release notes PR
------------------------

Open a new branch (e.g. `release`) and run the following:

    towncrier --version ${VERSION} --date `date -u  +%F`

This collects the release notes using the `towncrier` tool. Please commit the collected release
notes afterwards.

Certain file names are not properly supported by the `towncrier` tool and it ignores them.
Check `newsfragments` directory for any forgotten release notes

Step 3: Merge the release notes PR
----------------------------------

Step 4: Bump the version number
-------------------------------

Pull the merge commit created on the `master` branch during the step 2.

Edit the following files and update the version numbers:

 - `Build.properties`
 - `cmake/Version.cmake`
 - `doc/barrierc.1`
 - `doc/barriers.1`
 - `.github/ISSUE_TEMPLATE/bug_report.yml`

Commit to the release branch with the following message `Barrier x.y.z`.

Push the commit:

    git push origin master

Step 5: Push git tag
--------------------

Create a tag:

    git tag -s v${VERSION} -m v${VERSION}

Push the tag:

    git push origin master --tags


Step 6: Draft a new release on Github
-------------------------------------

Go to https://github.com/buildbot/buildbot/releases and draft a new release.

Use git tag as the title of the release: `vX.Y.Z`.

Use the release notes generated by the `towncrier` tool as the description of the releases.

Upload the artifacts created by Azure pipelines as the binaries of the release. The following
artifacts should be uploaded to Github:

 - the Barrier-X.Y.Z-release.dmg created by the newest Mac OS task (artifact name is
   "Mac Release Disk Image and App XYZ").

 - the BarrierSetup-X.Y.Z-release.exe (artifact name is Windows Release Installer).