Re: [RFC] Managing projects - advanced Git tutorial/walkthrough

From: J. Bruce Fields <bfields@fieldses.org>
Date: May 7, 2006, 01:34 UTC
Message-ID: <20060507013455.GB5709@fieldses.org>
In-Reply-To: <7v64kisyow.fsf@assigned-by-dhcp.cox.net>

On Sat, May 06, 2006 at 01:09:03PM -0700, Junio C Hamano wrote:

Show 8 quoted lines

>  - Understanding git as an end user.  Currently, this is
>    included in the global map git(7) documentation.  It might
>    make sense to separate it out.  This should talk about
>    concepts like blobs/trees/commits/trust/index without going
>    into lowlevel details of the implementation.  The stress
>    should be on what they are for, not operationally but
>    philosophically.  What's currently in README would be
>    suitable for this part, with some additional topics:

Yeah, I actually made a start at a sequel to tutorial.txt, with the goal that after reading the sequel a user would have encountered the main concepts necessary to read any of the man pages--mainly the object database and the index file. My work so far is in the "advanced-tutorial" branch of

	git://linux-nfs.org/~bfields/exports/git.git

but it needs some cleaning up.

I was hoping I'd be able to replace some of the README or core-tutorial.txt in the process, but the latter has a lot of git-hacker-only detail in it, and the former is a bit more verbose and has some motivation (explaining why stuff was designed the way it was) that is nice but maybe not necessary for a minimal tutorial.

--b.