Primer: Team Collaboration with Git & ATOM

In this video we give a brief introduction to doing team collaboration, and file versioning, with the Git software configuration management tool. The goal is to give the shortest introduction necessary to enable someone to use Git to collaborate with their teammates via Git and the Github cloud service.

The Challenge

I struggled a bit creating this tutorial because I wanted to introduce as few tools and concepts as possible.  However, Git is ultimately a command-line oriented tool and most of the graphical tools fall short of providing access to it’s full functionality.  However, I think that by viewing the video that accompanies this text you can get started using Git productively.

The Basic Workflows

There are three basic workflows we will cover in this tutorial:

  1. Your Project – you started a project on your machine and you want to share it, via Github, so your teammates can collaborate on it with you.
  2. Their Project – someone has shared a project, via Github, and you want to collaborate on it
  3. Our Project – you’re collaborating on project which has been shared on Github

The accompanying video demonstrates the above workflows.

The Toolset

In this tutorial I have limited myself to using the following Graphical User Interface based tools:

  • Your operating system’s native file explorer (Explorer on Windows, Finder on Mac)
  • Atom – a text editor provided by Github
  • Github Desktop – a GUI based tool also provided by Github
  • Github – a cloud based service for sharing versioned projects

If you don’t already have “Atom” and “Github Desktop” on your machine then you will want to follow the above links to their respective websites and install them before continuing with this tutorial.

You will also need to create yourself a Github account.  There are several subscription options for Github.  There is a free option which allows you to collaborate on existing projects and to create public projects.

Further Reading

After having watched the video you’ll realize it provided only a quick introduction to Git. If you decide you want to learn more then you can can have a look at the following resources:

  • The Git Book – an online book describing the concepts and commands for using Git