When you do a pull request, please open it to the dev
branch (not master
).
Each time you make a changes in the code, please write a note in the CHANGELOG.md file.
We follow the format from KeepChangelog.com. So, if it's a change in the dev
branch,
please write about your changes in ## [Unreleased]
section. Then, when the changes are merged to master
, the title is
changed to the corresponding version number.
If you merge any branch to master
, please follow the next steps:
- Run "walkthrough.Rmd" to ensure that the changes didn't break any functionality
- Increase version of the package in the DESCRIPTION file. We use Semantic Versioning guidelines. Briefly:
- all small fixes increase the 3'rd digit
- fixes, which change old behavior, i.e. break reproducibility increase 2'nd digit
- all large changes or changes, which break the user interface increase the 1'st digit
- Ensure that CHANGELOG contains information about all changes. Update the upper title from
## [Unreleased]
to the corresponding version number. - Tag the version for git release and docker rebuild:
git tag -a v1.1.2 -m "v1.1.2"
git push origin master --tags
- Alternatively, after pushing changes to master, on GitHub open "Releases" - "Draft new release", fill the tag name and description using the latest changes from CHANGELOG