On Thu, Nov 19, 2009 at 03:12:35PM -0500, George Dennie wrote: > > I think an important piece of conceptual information missing from the docs > is a concise list of the conceptual properties defining the context of the > working tree, index, and repository during normal use. This itemization > would go far in explaining the synergies between the various commands. Speaking about "normal use"... I suggest you read about Git workflows: $ git help gitworkflows > > Functionally, all the commands merely manipulate these properties. If these > properties were summarize in context one would expect that would represent a > very complete functional model of Git. A user could review the description > figure what they wanted to do and then find the command(s) to accomplish it. It is like to say that driving a car merely means to manipulate its components, so if these components were summarized, it would be all that one needs to know to drive a car... While I don't dispute that basic understanding of key Git concepts is important, understanding of a typical Git workflow cannot be deduced from knowledge of separate parts. Now if I were to describe Git just in a few words, I would say that Git repository is just a DAG of objects, the working tree is the place where you work, and the index is what helps you to create fine-grained commits and do merges. But it says very little (if anything) about how to use it. Dmitry -- To unsubscribe from this list: 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