Creating a Course Repository on GitHub {

This tutorial will take you through the steps needed to create the repository for your coursework on the website GitHub. Again, a repository is essentially a folder where you will save all your work and that will keep track of the history of your work over time. On your computer it will just look like a normal folder you put files in, but it has special powers!

Register for a GitHub Account

If you already have a GitHub account, skip this step. Otherwise, we need to register with GitHub so that we can create repositories that will be hosted by them (a bit like DropBox or Google Drive).

  1. Go to https://www.github.com/
  2. Either fill out the registration form that appears or click “Sign up” at the top right of the screen
  3. Follow the steps they require to create your account, including reply to the verification email
  4. Edit your profile, add an avatar image as you desire (not required)

Create a course repository

We will create a single repository to store all your coursework in called cart253. Lowercase is pretty standard for repository names.

  1. Go to https://www.github.com/
  2. Log in if you aren’t currently logged in
  3. Either click on the green “New” button or click the “+” button at the top right and select “New repository”
  4. Name the repository cart253 (or something similar)
  5. Add a short description like “This is Pippin Barr’s coursework repository for CART253”
  6. Set your repository to Public
  7. Select “Initialize this repository with a README”
  8. Click “Create repository”

Clone (download) your repository

  1. Run GitHub Desktop on your computer
  2. When prompted, sign in with your GitHub username and password set up during your registration
  3. It may ask you to set up things like an email address etc. Go ahead.
  4. Go to File > Clone Repository
  5. Select the “GitHub.com” tab
  6. Under Your Repositories select your cart253 repository (the one you created for this course)
  7. Under Local Path select a folder you want to save the repository (a folder) into on your computer
    1. This could be your Desktop, it could be your Documents folder, it could be wherever you keep your other courses’ materials, whatever suits you
    2. By default GitHub Desktop will create a GitHub folder in your main Documents folder and your repository folder will be in there
  8. Click “Clone” and the repository will be downloaded and it will also show up in your GitHub Desktop

You’re now ready to use GitHub Desktop and GitHub to save and synchronize all the projects you will end up creating for this course! As a simple rule, you should just keep all your work for the course in this cart253 repository folder.

Summary

We now have a GitHub account. We also have a repository (like a special folder that keeps track of your work over time) that exists locally on your computer (as a folder called cart253 or similar) and also remotely on GitHub.com (as a repository homepage called cart253). By keeping these two instances of the repository in synch, we can avoid many, many problems and also share our work much more easily. Because we enabled GitHub Pages, we can also share our work with anyone via a URL.

}