Hi, On Fri, 12 Dec 2008, David Howells wrote: > Documentation/git-haters-guide.txt | 1283 ++++++++++++++++++++++++++++++++++++ I am sure we want to have something like that in git.git. > +I don't really know what I'm doing with GIT either. Strike the "either". > +=============== > +OVERVIEW OF GIT > +=============== Your overview seems to be what "Git from the bottom up" is all about (see the Git Wiki for more information where to find it). >From my experience with new users, this is exactly the wrong way to go about it. You don't introduce object types of the Git database before telling the users what the heck they are good for. And most users do not need to bother with tree objects either, anyway. So maybe you just tell them what the heck the object types are good for, without even teaching them the object types at all. So I think that your document might do a good job scaring people away from Git. But I do not believe that your document, especially in the tone it is written, does a good job of helping Git newbies. Ciao, Dscho P.S.: No, I haven't read the whole document. Still, I think I am qualified enough to estimate what the average reader's first impression would be. -- 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
