Re: Considering teaching plumbing to users harmful

From: Junio C Hamano <gitster@pobox.com>
Date: Jul 17, 2008, 16:38 UTC
Message-ID: <7vzlogh3e7.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <20080717125536.GO2167@mit.edu>

Theodore Tso <tytso@mit.edu> writes:

Show 6 quoted lines

> 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.