From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 17 Jul 2008 16:38:40 GMT
Subject: Re: Considering teaching plumbing to users harmful
Message-ID: <7vzlogh3e7.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <20080717125536.GO2167@mit.edu>

Theodore Tso <tytso@mit.edu> writes:

> Have you taken a look at the intro-level materials such as "Everyday
> Git in 20 commands or so"[1], the git tutorial[2], the official "Git's
> User Manual"[3], or the "Git-SVN crash course"[4]?  Those are probably
> the best place to begin --- and to basically treat the git man pages
> as reference materials with a huge number of controls that you won't
> use or need to use for a long time --- if ever.

Good advice.

One caution is that I wrote the Everyday quite a while ago, certainly way
before 1.5.0, and I suspect the set of best commands and best ways to do
what these sections demonstrate to do may have changed.  I do not think
old ways stopped working (that would be a regression), but there would be
better ways invented after the document was last updated.