2  Git and Github workflow

(This is not meant to be a complete guide to git, but rather a short summary of key commands)

After your fork the bmm repository and create a branch for your new model/feature, you can follow a typical git workflow. As you make changes and add new files, you will want to:

2.1 Git commands

Add your changes to git, commit them and then push your changes to your forked repository. You can run these commands from a terminal or from the RStudio terminal (with the project working directory)

Add all changed files to the staging area:

git add *  

Commit the changes to the local repository

git commit -m "A short message describing the changes you made"

Push the changes to your forked repository

git push

You can (and should) repeat this process as many times as you need to before submitting a pull request. This will allow you to make many small changes and test them before submitting a pull request. Ideally each commit should be a small, self-contained change that can be easily reviewed.

2.2 Pull requests

When you are ready you can open a pull request from your forked repository to the main bmm repository. You can do this from the github website. Make sure to select the Develop branch as the base branch and your feature branch as the compare branch. You should add a detailed description of your changes, including the motivation for the changes and any relevant context. You should also mention any issues that your pull request resolves.