An improvement suggestion: do not use confusing terminology from other version control systems. Change "Checkout a repository" to "Clone an existing repository".
Using the word "checkout" might make sense if someone is coming from an svn/cvs background, but it's just confusing because checkout in git is a different command with a different meaning.
And besides, more and more people are being introduced to git without prior exposure to cvs or svn. E.g. in my university, CS freshmen submit their exercises using git. Many of them have no prior exposure to centralized version control or things to unlearn.
It seems to me that git tutorials are the new monad tutorials. The concepts are simple, but the names are confusing (see "checkout" or "return", "reset" or "bind").
There are a lot of tutorials like this one, but I think that they mostly help the writer (not that it's a bad thing).
The (in my opinion) scariest section for beginners (merging in the cast of conflict) is wrong (or at best, incomplete).
The problem I find beginners have with git (compared to svn) is not when things go right, it is when they go wrong -- in svn it is much harder to get yourself in a situation you cannot figure out how to get out of.
"gitk" is only part of the story. You'll see the branches and the commit contents, but you still need to run "git gui" to do the actual commit, reset changes, push.
14 comments
[ 2.4 ms ] story [ 44.1 ms ] threadhttps://github.com/rogerdudler/git-guide/
Using the word "checkout" might make sense if someone is coming from an svn/cvs background, but it's just confusing because checkout in git is a different command with a different meaning.
And besides, more and more people are being introduced to git without prior exposure to cvs or svn. E.g. in my university, CS freshmen submit their exercises using git. Many of them have no prior exposure to centralized version control or things to unlearn.
There are a lot of tutorials like this one, but I think that they mostly help the writer (not that it's a bad thing).
The problem I find beginners have with git (compared to svn) is not when things go right, it is when they go wrong -- in svn it is much harder to get yourself in a situation you cannot figure out how to get out of.