Step-by-step instructions for creating Github Releases like the pros.
- A more-or-less stable
devbranch ready to be merged into master
VERSION.txtfile holding release version
Pro Tip: keep release cycles short, release often!
Creating the release
VERSION.txtin your dev branch and fill it with the release number (e.g. 1.0-alpha1)
- Merge the master branch into dev
- Merge the dev branch back into master
- Go to the Github page holding your project and:
- Select releases
- Select Draft a new release
- Fill in 1.0-alpha1 as the Tag version
- Target the master branch
- Doublecheck before pressing the "Publish release" button
That's all there's too it, your first release.
Note: to prevent future merge conflicts caused by e.g. bugfixes... regularly merge master into dev!
Starting work on the next release
Now that the release is out, it's time to start work on the next one
VERSION.txtin the dev branch with the next release number (e.g. 1.0-alpha2)
- Commit and push change to dev
- Add features to your dev branch
Once you are ready to publish a new release... simply restart
Creating the release but skip step 1.