854
votes

Ok, after seeing this post by PJ Hyett, I have decided to skip to the end and go with Git.

So what I need is a beginner's practical guide to Git. "Beginner" being defined as someone who knows how to handle their compiler, understands to some level what a Makefile is, and has touched source control without understanding it very well.

"Practical" being defined as this person doesn't want to get into great detail regarding what Git is doing in the background, and doesn't even care (or know) that it's distributed. Your answers might hint at the possibilities, but try to aim for the beginner that wants to keep a 'main' repository on a 'server' which is backed up and secure, and treat their local repository as merely a 'client' resource.

So:

Installation/Setup

Working with the code

Tagging, branching, releases, baselines

Other

Other Git beginner's references

Delving into Git

I will go through the entries from time to time and 'tidy' them up so they have a consistent look/feel and it's easy to scan the list - feel free to follow a simple "header - brief explanation - list of instructions - gotchas and extra info" template. I'll also link to the entries from the bullet list above so it's easy to find them later.

0

37 Answers 37

1
2
5
votes

Resource: Definitely check out Scott Chacon's Gitcasts, especially the Railsconf talk.

Github is awesome and also has some helpful guides.

5
votes

Seriously add the link featured in Tim's answer in the Stack Overflow post Setup Git Server with Msysgit on Windows.

It flawlessly told me how to setup Git on Windows with msysgit, and is an incredibly detailed article.

0
5
votes

WRT good GUIs/frontends, you may also want to check out qgit which is a cross-platform (Linux/Win32) repository viewer for Git and can be also used as high level frontend for the most common Git operations, in fact it can be easily enhanced by so called "custom actions" so that users can provide customized actions.

5
votes

What is rebasing?

Rebase explanation taken from the book Pragmatic Guide to Git - Travis Swicegood

Chapter III

16 . Rewriting History by Rebasing

Rebasing commits is the one concept in Git that has no counterpart inside the traditional version control world. Using git rebase, you can rewrite the history of a repository in a variety of ways. It is one of the most powerful commands in Git, which makes it one of the most dangerous.

rebase takes a series of commits (normally a branch) and replays them on top of another commit (normally the last commit in another branch). The parent commit changes so all the commit IDs are recalculated. This can cause problems for other developers who have your code because the IDs don’t match up.

There’s a simple rule of thumb with git rebase: use it as much as you want on local commits. Once you’ve shared changes with another developer, the headache is generally not worth the trouble.

2
  • 1
    Worth mentioning: if a rebase hits a merge conflict and you want to stop the rebase, use git rebase --abort. Everything will be back to the way it was before you started. And: Don't know if you want to mention this here (it seems less beginner-y), but you can also rebase --onto.
    – torek
    Mar 23, 2012 at 6:37
  • I think one extremely important aspect, which isn't mentioned here, is how rebase reorders history. Rebase orders history so the commits are stored clean and linear instead of interleaving from merge conflict resolutions during fetch/merge operations. Rebase also extracts your changes from origin and applies remote changes first, so you only have to resolve conflicts in reference to your changes, not the incoming changes. Apr 13, 2012 at 15:50
4
votes

I found this post to be very useful to get me started. I still need to read the book and other resources but the post was helpful in, as the title says, "understanding git conceptually". I also recommend taking the Git & GitHub course offered at RubyLearning.

1
  • 1
    Not really the goal of the posters question since he wants this question to work as a one stop shop for new git users. Aug 29, 2009 at 1:45
4
votes

One more item I really think should be in this list, probably very useful for beginners:

Don't Panic

What if I've done some commits and then I did something scary, like maybe a rebase, and now something—or even everything—seems to be lost? (Rebase seems to be the one that gets most people the first time, so I'm concentrating on it. While git rebase --abort helps a lot, sometimes you'll find that you botched an edit during an interactive rebase, for instance, and let the rebase finish and now you want to get your old stuff back. And then there are things like filter-branch...)

One key git principle is that it never actually deletes anything you've committed. ("What, never?" "No, never!" "What, never?" "Well, hardly ever!") If you have not run git gc, it's still in there. It may take some digging around to find your previous work, but if you did some successful git commits earlier, then, for instance, even your apparently-wrecked series of commits from a tragic rebase error are still in there, normally for at least a month (technically, until the "reflogs" expire).

It's important to keep in mind that each branch name labels—or points to—a "commit-ID". These are the the funny numbers like 7cc5272. Many of the things you do, like adding a new commit to a branch, make the branch name point to a new, different commit-ID. Each commit-ID has a link pointing back to some previous commit-ID(s), and this is what actually makes up a "branch" full of commits.

The rebase entry talks about "rewriting history," and commands like git filter-branch also "rewrite history," but they do it not by destroying the previous history, but rather by adding new history. Once the new history is in place, git will "move the labels around" so that it looks like history has changed. If you are on your fix-nasty-bug branch and do a git rebase and manage to wreck things, the label fix-nasty-bug now refers to the wreckage, but the original versions are still there. Rebase in particular makes a temporary (non-moving, not-a-branch) label spelled ORIG_HEAD that lets you find them. The filter-branch command saves all the original names as well. In some cases, there may be no obvious name, but the commits can always be found. If necessary, find yourself a "git guru" and explain what you did that led to the wreckage.

(The command git reflog show can also help with finding commit-IDs.)

If you have found what you think is some or all of your previous work, try:

git log <commit-ID>   # ORIG_HEAD after a bad rebase, for instance
git show <commit-ID>  # or some long SHA1 value you can still see in a window

If it looks right or useful, put a name to it:

git branch recover-my-stuff ORIG_HEAD

and it's all back again! In fact, now both your bad rebase and your original work are in your git repo "forever" (or at least, until you delete the branch names and let a few months go by, and then they get garbage-collected). You can put as many names to as many recovered commits as you like. (Branch names are virtually free, except for cluttering up your git branch output, and of course they also keep commits from being garbage-collected. You can also, or instead, put tags on specific commit-IDs, if you prefer those.)

0
votes

Very good post on merging with conflicts - GitGuys: Merging With a Conflict - Conflicts And Resolutions

The blog is really great - illustrative, clean examples and understandable. Definitely worth checking out.

1
2

Not the answer you're looking for? Browse other questions tagged or ask your own question.