How to release a new version of DemocracyOS

Requirements

• Git Extras

Releases must be started from the master or the development branch exclusively. Hotfixes should start from master while new features should always come from development. So, first thing to do should be:

git checkout master

or

git checkout development

Then create a new branch with a descriptive name of the release, like fix/law-comments or add/some-new-feature or release-X.Y.Z

git checkout -b release-X.Y.Z

First thing on that branch is pushing it to origin with git push -u origin HEAD. Then update the History.md file with

git changelog --tag x.y.z

being x.y.z the version number. After that, use the same x.y.z to update the package.json and component.json placed at the project root and give a proper styling to History.md file (delete the branch merges lines and give the text more expressiveness. Add these changes with git add . -p to review each line. To perform the release, do:

git release x.y.z

Then merge this release branch into master:

git checkout master
git merge --ff release-X.Y.Z
git push

If you want to deploy to some environment, at this point do:

git push my-environment master

Then take this new branch into development as well:

git checkout development
git merge --no-ff fix/some-feature
git push

And you're done.

This release process was inspired by this article. Kudos to @nvie