Version Control Tutorials

Version control is a way of managing changes in your projects! It is useful whether or not you are a programmer, artist, or any other role on a software project.

The below tutorials are written to help you figure out, in simple, non-technical terms, how to get set up and running.

Text Tutorial: Git

In this tutorial, you will learn how to use Git, a new but commonly used version control system!

Download TortoiseGit (Windows)  Download GitHub (Mac)

Installation

Start by downloading the installer given above. Which one you should use depends on your operating system - OSX users should use GitHub, while Windows users will find TortoiseGit extremely intuitive.

Next you will need to actually install the client. Execute the install program, choose an installation directory, and let the software be installed onto your system. Click the link below for more detailed instructions (Windows users - there are other dependencies that the installer should resolve for you. If not, I will add my own detailed steps.)

TortoiseGit Install Instructions  GitHub Install Instructions

How To: Place an existing project under Git source control

Now that a Git client is set up on your system, you will need to put a project under control to start immediately getting benefit from Git!

Windows Users

  1. The first thing to do is find the folder you want to place under control. Right click it; a context menu should appear with new options!

    Context menu is open for a folder, with Git Create Repository Here selected.
  2. Click Git Create Repository Here... A confirmation prompt will appear!

    Confirmation prompt for creating a new repository.

    You'll notice the checkbox, 'Make it Bare'. This is only for brand new folders that have nothing in them. You're setting up an existing project, so leave this unchecked. Click OK.
  3. A confirmation should appear, 'Initialized Git repository at [path]'. That means, you succeeded! Click OK.

    Confirmation message showing that your repository was all set up!

Mac Users

(In Progress)

How To: Pull Down an Existing Project from a remote server

More often than not, these instructions will come in handy when you've started on a team with a project in-progress. The team already has their project under source control, and on a remote server (we'll talk about how you'd do that in just a little bit!), you just need to get a copy on your machine so you can start working. Here's how you do it...

Windows Users

  1. Right-click on your desktop. Click Git Clone... A dialogue will appear.

  2. Enter the URL of the team's repo (they'll tell you what this is.) TortoiseSVN should automatically fill in the destination for you.

    Ignore everything else, and click OK.
  3. A Git command progress window will appear and do stuff. Just let it finish.

    When you see Success, you're done! Click Close.
  4. You should be viewing your desktop. Click into that folder we just created and pulled stuff into.

    You should now have files inside it, with a little checkmark on the file icons!

Mac Users

(In Progress...)