Release Procedure

Preconditions for Release:

If the release is a milestone release: no open tickets for the milestone
Travis CI on devel is passing (http://ci.radical-project.org/job/radical.entk.devel/branch/devel/)

Create a branch from the latest master: e.g. git checkout master; git pull; git checkout -b release/1.0.1
Update the version file: echo "1.0.1" > VERSION
Make modifications to the branch: followed by merging devel git merge devel (make sure to pull devel before)
Update release notes: $EDITOR CHANGES.md
Commit and push: git commit -a; git push release/1.0.1
Create pull-request of release branch to the master (base): https://github.com/radical-cybertools/radical.entk/pulls
Wait on and/or nudge other developers to review and test
If not approved, GOTO 3

Create a branch from the latest master: e.g. git checkout master; git pull; git checkout -b hotfix/issue_123
Update version echo "1.0.1" > VERSION
Make modifications to the branch: either by $EDITOR or git cherry-pick abcsuperdupercommit890 (The latter is preferred)
Update release notes: $EDITOR CHANGES.md
Commit and push: git commit -a; git push hotfix/issue_123
Create pull-request of hotfix branch to the master(base): https://github.com/radical-cybertools/radical.entk/pulls
Wait on and/or nudge other developers to review and test
If not approved, GOTO 3

If approved, move to master branch and pull in the merged content: git checkout master, then git pull
Create tag: git tag -a v1.0.1 -m "release v1.0.1.2"
Push tag to GitHub: git push --tags
Release on PyPI: python setup.py sdist; twine upload --skip-existing dist/radical.entk-1.0.1.tar.gz
Verify PyPI version on: https://pypi.python.org/pypi/radical.entk

Merge master into devel branch: git checkout devel; git merge master; git push origin devel
Merge devel into all open development branches: for b in $branches; do git checkout $b; git merge master; done
Delete the branch for the release e.g. release/1.0.1 or hotfix/issue_123