Lesson 1. Version control intro and setup

Introduction to version control and Git - course module

Welcome to the first lesson in the Introduction to version control and Git module. Learn why version control is useful to science workflows and how to use git and GitHub for version control to back up your work.

Introduction to Git / Github workshop

Key course materials

What you need

To participate in this workshop, you need to have Git and Bash installed on your computer. Please follow the instructions below to install this PRIOR to showing up for the workshop.

Data Tip: Anyone with an .edu email affiliation can get a free GitHub account with unlimited private repos. Learn more here.

Workshop schedule

1:00 - 2:30Intro to version control & Git - commit, push, pullMax
2:30 - 2:40Break 
2:40 - 4:00Pull requests and cloning + reviewLeah

Step 1. Setup Git and Bash

Windows instructions

  • Install Bash on your computer. Please note that Windows command prompt is not the same as Bash - we suggest that Windows users install Git for Windows, which also installs Bash as described in the Software Carpentry instructions.

Mac or Linux instructions

Step 2. Sign up for GitHub

Create a GitHub account

If you do not already have a GitHub account, go to GitHub and sign up fora free account. Pick a username that you like! This username is what your colleagues will see as you work with them in GitHub and Git.

Take a minute to setup your account. If you want to make your account more recognizable, be sure to add a profile picture to your account!

If you already have a GitHub account, verify that you can sign in.

Step 3. Configure Git on your computer

Head over to Software Carpentry and follow the steps to configure Git on your computer.

Be sure to set up your username and e-mail from the command line.

$ git config --global user.name "Your Name"
$ git config --global user.email "[email protected]"
$ git config --global color.ui "auto"

Please configure your text editor as well. Follow the software carpentry lessons and if they don’t make sense we can go through this together during the workshop.

If you’re not sure whether you’ve already configured Git, you can list your configuration by executing git config --list.