# Best newbie / advanced / expert reference texts for Git?

11 messages from 2010-11-19 to 2010-11-19. Participants: Dun Peal, Patrick Doyle, Nguyen Thai Ngoc Duy, Konstantin Khomoutov, Jakub Narebski, Scott Chacon.
Thread: https://gitlist.dev/t/25786

## Dun Peal, 2010-11-19 11:02

Subject: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTikctrASqX0FLCOapyJCt1VqG6_cxs_oXJ6fExZC@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTikctrASqX0FLCOapyJCt1VqG6_cxs_oXJ6fExZC%40mail.gmail.com

```
Hi there,

What are the best texts for the following three levels of knowledge:

1. Newbie: someone who used a simple, centralized SCM (such as SVN)
but never touched Git.
2. Intermediate: someone who uses Git's simpler features, and can do
simple branching/merging, but would like to fully understand the
underlying concepts such as the DAG, and master all common user-level
operations such as branching, merging, and rebasing.
3. Advanced: someone who knows all the above, but would like to know
everything there is to know about Git.

The target audience in my particular case is smart, with strong CS
background, especially those in the two latter categories.

Being available online is a plus, but will not disqualify a good
offline reference.

Thanks, D

```

## Patrick Doyle, 2010-11-19 11:18

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTik5ZYC66NicUvbDxJMiR_0iK3vPRAf9dGAQu+qW@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTik5ZYC66NicUvbDxJMiR_0iK3vPRAf9dGAQu%2BqW%40mail.gmail.com
In-Reply-To: <AANLkTikctrASqX0FLCOapyJCt1VqG6_cxs_oXJ6fExZC@mail.gmail.com>

```
On Fri, Nov 19, 2010 at 6:02 AM, Dun Peal <dunpealer@gmail.com> wrote:
> Hi there,
>
> What are the best texts for the following three levels of knowledge:
>
> 1. Newbie: someone who used a simple, centralized SCM (such as SVN)
> but never touched Git.
> 2. Intermediate: someone who uses Git's simpler features, and can do
> simple branching/merging, but would like to fully understand the
> underlying concepts such as the DAG, and master all common user-level
> operations such as branching, merging, and rebasing.
> 3. Advanced: someone who knows all the above, but would like to know
> everything there is to know about Git.
>
> The target audience in my particular case is smart, with strong CS
> background, especially those in the two latter categories.
>
> Being available online is a plus, but will not disqualify a good
> offline reference.
Check out http://progit.org/.  I am not affiliated with the author(s)
or the web site.  I just stumbled across it a couple of weeks ago when
I went to set up a git server for our group.  It seems to answer every
question I've ever had about git, and then some.

--wpd

```

## Dun Peal, 2010-11-19 11:38

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTin_kS_2d=ajuGo-V_OWsF91xSb=SeKmrX9Aghe8@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTin_kS_2d%3DajuGo-V_OWsF91xSb%3DSeKmrX9Aghe8%40mail.gmail.com
In-Reply-To: <AANLkTik5ZYC66NicUvbDxJMiR_0iK3vPRAf9dGAQu+qW@mail.gmail.com>

```
On Fri, Nov 19, 2010 at 11:18 AM, Patrick Doyle <wpdster@gmail.com> wrote:
> Check out http://progit.org/.  I am not affiliated with the author(s)
> or the web site. I just stumbled across it a couple of weeks ago when
> I went to set up a git server for our group. It seems to answer every
> question I've ever had about git, and then some.

Thanks; sounds like it should serve well for the Advanced and possibly
Intermediate categories. Still need a good text for the Newbie class.

P.S. I glanced at it briefly and it seemed a bit out of date, but
perhaps my inspection was too cursory.

D

```

## Nguyen Thai Ngoc Duy, 2010-11-19 12:14

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTinmPsL8zJCAVDibb3EA7RuLP3usRVSSyooPuma8@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTinmPsL8zJCAVDibb3EA7RuLP3usRVSSyooPuma8%40mail.gmail.com
In-Reply-To: <AANLkTikctrASqX0FLCOapyJCt1VqG6_cxs_oXJ6fExZC@mail.gmail.com>

```
On Fri, Nov 19, 2010 at 6:02 PM, Dun Peal <dunpealer@gmail.com> wrote:
> 3. Advanced: someone who knows all the above, but would like to know
> everything there is to know about Git.

It's obvious: the source code and its history, then old timers (ok no
more texts) who can tell you its history, original design...
-- 
Duy

```

## Konstantin Khomoutov, 2010-11-19 14:53

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <20101119175354.350f982f.kostix@domain007.com>
URL: https://gitlist.dev/e/20101119175354.350f982f.kostix%40domain007.com
In-Reply-To: <AANLkTin_kS_2d=ajuGo-V_OWsF91xSb=SeKmrX9Aghe8@mail.gmail.com>

```
On Fri, 19 Nov 2010 11:38:26 +0000
Dun Peal <dunpealer@gmail.com> wrote:

>> Check out http://progit.org/.  I am not affiliated with the author
>> (s) or the web site. I just stumbled across it a couple of weeks
>> ago when I went to set up a git server for our group. It seems to
>> answer every question I've ever had about git, and then some. 
> Thanks; sounds like it should serve well for the Advanced and possibly
> Intermediate categories. Still need a good text for the Newbie class.

http://git-scm.com/course/svn.html
http://stackoverflow.com/questions/1042280/a-subversion-users-guide-to-git
and
http://www.google.com/search?q=git+for+svn+users in general.

Also there's a very good DVCS introductory writing for real
newbies which deals with concepts rather than commands --
http://tom.preston-werner.com/2009/05/19/the-git-parable.html

```

## Jakub Narebski, 2010-11-19 15:44

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <m3vd3t48uy.fsf@localhost.localdomain>
URL: https://gitlist.dev/e/m3vd3t48uy.fsf%40localhost.localdomain
In-Reply-To: <AANLkTin_kS_2d=ajuGo-V_OWsF91xSb=SeKmrX9Aghe8@mail.gmail.com>

```
Dun Peal <dunpealer@gmail.com> writes:
> On Fri, Nov 19, 2010 at 11:18 AM, Patrick Doyle <wpdster@gmail.com> wrote:

> > Check out http://progit.org/.  I am not affiliated with the author(s)
> > or the web site. I just stumbled across it a couple of weeks ago when
> > I went to set up a git server for our group. It seems to answer every
> > question I've ever had about git, and then some.
> 
> Thanks; sounds like it should serve well for the Advanced and possibly
> Intermediate categories. Still need a good text for the Newbie class.
> 
> P.S. I glanced at it briefly and it seemed a bit out of date, but
> perhaps my inspection was too cursory.

"Pro Git" out of date.  Oh really?  It is kept quite up to date (for
example adding information about "gitolite" and "smart" HTTP
transport), see https://github.com/progit/progit

As to other documentation, see
  https://git.wiki.kernel.org/index.php/GitDocumentation

-- 
Jakub Narebski
Poland
ShadeHawk on #git

```

## Dun Peal, 2010-11-19 15:47

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTi=wdWkZCyg6vHOaDZS=oeWAX_EhCgOLFGJOwC9G@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTi%3DwdWkZCyg6vHOaDZS%3DoeWAX_EhCgOLFGJOwC9G%40mail.gmail.com
In-Reply-To: <m3vd3t48uy.fsf@localhost.localdomain>

```
On Fri, Nov 19, 2010 at 3:44 PM, Jakub Narebski <jnareb@gmail.com> wrote:
> "Pro Git" out of date. Oh really? It is kept quite up to date (for
> example adding information about "gitolite" and "smart" HTTP
> transport), see https://github.com/progit/progit
>
> As to other documentation, see
> https://git.wiki.kernel.org/index.php/GitDocumentation

Wow, that's pretty cool. Any idea how often the online version at
http://progit.org is synced with the github version?

D

```

## Scott Chacon, 2010-11-19 15:54

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTimckSDtkfoVqvEACNUhMHAKVvTKcCCmm=VdavJL@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTimckSDtkfoVqvEACNUhMHAKVvTKcCCmm%3DVdavJL%40mail.gmail.com
In-Reply-To: <AANLkTin_kS_2d=ajuGo-V_OWsF91xSb=SeKmrX9Aghe8@mail.gmail.com>

```
Hey,

On Fri, Nov 19, 2010 at 11:38 AM, Dun Peal <dunpealer@gmail.com> wrote:
> Thanks; sounds like it should serve well for the Advanced and possibly
> Intermediate categories. Still need a good text for the Newbie class.

For newbies as a sort of shorter tutorial/reference I also have
http://gitref.org
These and other resources are listed out in http://git-scm.com/documentation

> P.S. I glanced at it briefly and it seemed a bit out of date, but
> perhaps my inspection was too cursory.

It is up to date as of 1.6.x - I have pulled in updates in some parts
and added blog posts on newer features and whatnot, but the main text
even should not really be noticeably out of date.  At some point I
will roll the blog post updates back into the main text.

Do you have any examples?

Scott

```

## Scott Chacon, 2010-11-19 15:56

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTikTEcPqeGtLEFKMCsiv9zC7Jj-E_3mrjDrR7fJR@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTikTEcPqeGtLEFKMCsiv9zC7Jj-E_3mrjDrR7fJR%40mail.gmail.com
In-Reply-To: <AANLkTi=wdWkZCyg6vHOaDZS=oeWAX_EhCgOLFGJOwC9G@mail.gmail.com>

```
Hey,

On Fri, Nov 19, 2010 at 3:47 PM, Dun Peal <dunpealer@gmail.com> wrote:
> On Fri, Nov 19, 2010 at 3:44 PM, Jakub Narebski <jnareb@gmail.com> wrote:
>> "Pro Git" out of date. Oh really? It is kept quite up to date (for
>> example adding information about "gitolite" and "smart" HTTP
>> transport), see https://github.com/progit/progit
>>
>> As to other documentation, see
>> https://git.wiki.kernel.org/index.php/GitDocumentation
>
> Wow, that's pretty cool. Any idea how often the online version at
> http://progit.org is synced with the github version?

I merge it in and push changes every month or so now.  It was more
often, but the errata and translations are coming in less frequently.
I have a number of pull requests pending, mostly for formatting fixes
and translation additions.  I'll probably do another merge/push around
Thanksgiving.

Scott

```

## Dun Peal, 2010-11-19 17:08

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTinuuU+PqYQs=4XywUsrSyd3evFbRK+2_WxEAoZo@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTinuuU%2BPqYQs%3D4XywUsrSyd3evFbRK%2B2_WxEAoZo%40mail.gmail.com
In-Reply-To: <AANLkTimckSDtkfoVqvEACNUhMHAKVvTKcCCmm=VdavJL@mail.gmail.com>

```
On Fri, Nov 19, 2010 at 3:54 PM, Scott Chacon <schacon@gmail.com> wrote:
> For newbies as a sort of shorter tutorial/reference I also have
> http://gitref.org

Cool, looks like what I need for the Newbie class.
> These and other resources are listed out in http://git-scm.com/documentation

Yeah there are definitely a lot of resources listed there; so many,
that one can't readily decide which to use and for what purpose ;-)

>> P.S. I glanced at it briefly and it seemed a bit out of date, but
>> perhaps my inspection was too cursory.
>
> Do you have any examples?

I just glanced through a description of checking out branches and
didn't see the feature that creates a remote-tracking branch foo when
you `git checkout foo`, and foo isn't a local branch but does exist on
the remote.

Very cool of you to open your text up like that. I'll get a bunch of
copies of ProGit ordered as soon as I can.

D

```

## Scott Chacon, 2010-11-19 17:20

Subject: Re: Best newbie / advanced / expert reference texts for Git?
Message-ID: <AANLkTins84umA=o=HLCtrFS=om-c_7yEGQzcxDvYv7-D@mail.gmail.com>
URL: https://gitlist.dev/e/AANLkTins84umA%3Do%3DHLCtrFS%3Dom-c_7yEGQzcxDvYv7-D%40mail.gmail.com
In-Reply-To: <AANLkTinuuU+PqYQs=4XywUsrSyd3evFbRK+2_WxEAoZo@mail.gmail.com>

```
Hey,

On Fri, Nov 19, 2010 at 5:08 PM, Dun Peal <dunpealer@gmail.com> wrote:
> Yeah there are definitely a lot of resources listed there; so many,
> that one can't readily decide which to use and for what purpose ;-)

Hm, perhaps I should simplify the page a bit then.

>>> P.S. I glanced at it briefly and it seemed a bit out of date, but
>>> perhaps my inspection was too cursory.
>>
>> Do you have any examples?
>
> I just glanced through a description of checking out branches and
> didn't see the feature that creates a remote-tracking branch foo when
> you `git checkout foo`, and foo isn't a local branch but does exist on
> the remote.

Well, that will never be included - I find it really confusing and try
to discourage people from using it in favor of 'git checkout -b foo
origin/foo' because i feel it's much more consistent.   I would like
to make the tracking branch section a bit better, but that's not
really an 'out of date' thing.

Thanks again,
Scott

```
