Module 5 Version Control
5.1 Before Class #5
5.1.1 Install git on your computer
Access the git download page and download the appropriate version for your machine.
If you have a Windows 10 machine, you can watch this video that shows you how to install Git on windows. When installing, note where it’s installed (on the “Select Destination Location” window) so you can check if you have the correct path to Git set up in RStudio (it’s usually
If you have a Mac, you can watch this video that shows you how to install Git on a Mac.
5.1.2 Create a GitHub account
Access the GitHub page.
Click on “Sign Up for GitHub.”
Fill out the “Create your account” forms.
A verification will be sent to your email address, check your inbox for a “Please verify your email address” message. Click on “Verify email address” button.
If you already have a GitHub account, confirm you know your username and password by logging in at GitHub.
5.2 What is version control?
Version control is a best practice for reproducible analyses, and widely used in industry and research (i.e., you will need to know how to use version control in your future job).
The purpose of version control is to keep track of changes to your files over time, so that you can recall specific versions at any point in your project.
Git is an open source version control software system that is very popular – 58% of data scientist use Git (Beckman et al. 2020). There are a number of other version control software available (e.g., Perforce).
5.3 Submitting assignments
5.3.1 Clone assignment repository
Go to our first assignment GitHub repository
Click on the “Code” button and copy the git url (e.g., https://github.com/esoc214/test-assignment-yournamehere.git)
Go “File” > “New Project…”
In the pop-up window, select “Version Control”
Then choose “Git”
In the “Repository URL:” field enter the link to the first assignment repository from your GitHub account.
5.3.2 Modify files
For the first assignment, which is a test assignment so you’re all set up to submitting all of your assignments for this class, you need to modify
READM.md only. For other assignments you will need to edit .R scripts.
5.3.3 Commit changes
On the top right panel in RStudio (i.e., Environment quadrant), click on the “Git” tab
You will see a list of files, indicating which files have been modified (a blue “M” shows next to modified file).
Click on “Commit” on the top of this tab
A new window will pop-up. Stage the files you want to commit (click on the check box next to file) and enter a commit message.
Press “Commit” and if everything looks good, close the commit window.
Click “Push” on top right
Beckman, Matthew D, Mine Çetinkaya-Rundel, Nicholas J Horton, Colin W Rundel, Adam J Sullivan, and Maria Tackett. 2020. “Implementing Version Control with Git as a Learning Objective in Statistics Courses.” arXiv Preprint arXiv:2001.01988.