Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

67 lines (46 sloc) 2.995 kb

DO NOT BE AFRAID

We are (finallly) switching over to Git for source code management. Don't worry - it's actually easy to learn, and the day-to-day usage is fairly similar to Subversion.

This guide is a work-in-progress, so please edit and improve it! Your first git push origin could add some great info that will help new developers make the transition.

Quickstart

We're all in a hurry, so here are the steps you'll need to follow to get up and running with git.

  1. Create an account at github.com.
  2. Ask John to link your github.com account to the Lumos Labs organization. This will give you access to our private repositories.
  3. Follow github.com's "Set Up Git" guide: OS X and Windows versions are available. They explain this stuff better than I ever could.

    A couple of important notes about SSH keys:

    • If you already have an SSH key for access to our servers, please create a different key to use for Github access. You can use ssh-keygen -t dsa to do this, using something like github_dsa for the name of your identity file.

      Then, edit the file $HOME/.ssh/config (or create if it doesn't exist) and add the following lines to tell ssh that it should use your custom github key when connecting to their servers:

      Host github.com
      IdentityFile ~/.ssh/github_dsa
      
    • Please add a passphrase to your SSH key. This is less inconvenient than it sounds, at least on OS X, because the system's keychain app will store your password. To add a passphrase to an existing key, use ssh-keygen -p.

  4. Clone the lumoslabs/lumos_sandbox repo (this one!) onto your local machine:

    git clone git@github.com:lumoslabs/lumos_sandbox.git
    
  5. Play around! Get comfortable with the normal git workflow:

    • modify and create files in this sandbox repo
    • stage the changes for commit (git add <file>)
    • commit the changes to your local repo (git commit)
    • push the changes to the remote repository (git push)
    • fetch and merge other developers' changes into your repository (git pull)

There's obviously much more to learn about git, but this much should at least get you up and running.

Digging Deeper

These are left as exercises to the reader. Feel free to modify this README with notes on how to do any of the steps!

  • Read about the fundamentals of how git works
  • Create a branch and push it to a remote repository.
  • Merge a branch back into the master branch.
  • Use git rebase to squash multiple commits into a single commit.

Resources

Jump to Line
Something went wrong with that request. Please try again.