Feedback outside of the user survey

Hi all,

unfortunately, I did not know there was a survey, so I did not participate in it.

I still want to give some feedback from my experiences with git. From browsing the results [1] of said survey, I see one request being made a lot of times. It's basically my main gripe with git, as well :)

git can do a lot of things, but, as a new user, you are never quite sure where to start. Docs are geared towards advanced users (which is fine), but there is no easy entry point (which is bad).

I would suggest three approaches to fix this:

1) A table/An overview along the lines of "So, you are used to
foo and that is how you do it in git."
For example "What is the equivalent of svn co" (yes, that is an
easy one ;). This should not be limited to things git can do.
svn's ability to pull a subdirectory, which is, ttbomk, lacking
in git, should be included, as well. I am sure there are other
examples [2].

2) A use case repository. "So you want to merge two
branches", etc. This would be a good place to explain the
different ways git offers to do stuff, as well.

3) A tutorial. It does not even have to be as sophisticated
as vimtutor. A simple text file specifying steps to do stuff
would be enough.

Thanks, Richard

[1] http://www.survs.com/app/2/wo/7OeqmUsbjaDuuaLsOCLeSg/0.0.9.3.3.0.1.3.33.1.7.1 [2] http://www.survs.com/app/2/wo/7OeqmUsbjaDuuaLsOCLeSg/0.0.9.3.3.0.1.3.14.1.7.1