On Sat, May 06, 2006 at 01:09:03PM -0700, Junio C Hamano wrote: > - 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. - : send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html