Re: Feedback outside of the user survey

From: Jeff King <peff@peff.net>
Date: Oct 16, 2008, 10:28 UTC
Message-ID: <20081016102835.GC20762@sigill.intra.peff.net>
In-Reply-To: <2d460de70810160319r4bed8643g884508cdeba772@mail.gmail.com>

On Thu, Oct 16, 2008 at 12:19:36PM +0200, Richard Hartmann wrote:

> 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.

How about:

  Git - SVN Crash Course
  http://git.or.cz/course/svn.html

> 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.

How about:

  Git User's Manual
  http://www.kernel.org/pub/software/scm/git/docs/user-manual.html

(though I do think a user-contributed "recipe" database might be useful. Maybe such a thing even exists already and I don't know about it).

> 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.

How about:

  The Git Tutorial
  http://www.kernel.org/pub/software/scm/git/docs/gittutorial.html

Is there something about these that doesn't meet your criteria? Or did you not know about them (in which case, maybe we need to be more prominently pointing to them)?

-Peff