Re: Git Documentation

From: Pedro Melo <melo@simplicidade.org>
Date: Jul 22, 2008, 10:15 UTC
Message-ID: <EDFF27AB-9B74-4868-A0BF-61AC8ED75037@simplicidade.org>
In-Reply-To: <d411cc4a0807212035v68c2ed95m93b77c1e61cfec9e@mail.gmail.com>

Hi,

On Jul 22, 2008, at 4:35 AM, Scott Chacon wrote:

Show 20 quoted lines

> I'm starting a project to host a really nice, user-friendly, easy to
> use Git learning materials website for Git newbies to get new users
> started and make it as easy to learn as possible.  I'll be redoing or
> editing some of my screencasts from gitcasts.com and starting an open
> book at github and putting it all in one place for new users to get
> started easily.  Anyone will be free to submit changes, additions,
> etc.
>
> If anyone has any tips on how they think git should be taught, issues
> they are asked a lot, problems newbies tend to have, something they
> wish there were a screencast for or was better documented, etc -
> please do contact me so I can incorporate it.  I would contribute to
> git itself, but my C-foo is seriously wanting, so if by teaching
> people properly I can free up some time for you guys, I would love to
> do so.
>
> Please let me know if you have any pointers or think anything should
> really be better documented for end-users.  I plan to do a lot of
> graphics, screencasts and whatever else makes it as simple as
> possible.

A section on usual workflows and setups would be most useful. Some like a pull/push workflow, others a email based workflow.

As for learning git stuff, I usually point new users to your stuff :). I also point them to Tommi Virtanen "Git for Computer Scientists":http://eagain.net/articles/git-for-computer-scientists/ . It was that article that made it all "click" for me regarding git.

Best regards,

-- 
Pedro Melo
Blog: http://www.simplicidade.org/notes/
XMPP ID: melo@simplicidade.org
Use XMPP!