Re: Git Community Book

From: Scott Chacon <schacon@gmail.com>
Date: Sep 5, 2008, 20:45 UTC
Message-ID: <d411cc4a0809051345p1c1b127epa7a186f49414a1fc@mail.gmail.com>
In-Reply-To: <18071eea0809051215n6a8e1468gfd28876d7d5b0488@mail.gmail.com>

On Fri, Sep 5, 2008 at 12:15 PM, Thomas Adam <thomas.adam22@gmail.com> wrote:

Show 8 quoted lines

> 2008/9/5 Scott Chacon <schacon@gmail.com>:
>> Hey all,
>>
>> I just wanted to let those of you who are interested know that I've
>> been making a lot of progress on the Git Community Book
>> (http://book.git-scm.com)  I was wondering if anyone was interested in
>
> I'm going to bite and ask the obvious questions:

Just for reference, a lot of this was discussed here a while back:

http://thread.gmane.org/gmane.comp.version-control.git/90653

however, I would be happy to answer these for you.

>
> 1.  How does what you're producing differ from the current Git Users' Manual?

I'm going for a different audience with this project. I'd like for it to be a lot more user-friendly, easily digestible, and to include images, diagrams and screencasts.

> 2.  Is this project of yours aiming to obsolete the Git Users' Manual
> with "official" sanctioning from people involved with Git?

I think there will be people who prefer the Users Manual format, who
think screencasts are wussy :)
Also, I'm not sure an "official" sanctioning would do much of anything
- because of the images and screencasts, this will never be included
in the git source like the UM is, but it's also open source so if
people want to take content from it to improve the UM, that's cool.

> 3.  Assuming 2 is a "no", patches to the Users' Guide would be nice.  :)

I would love to do this, but I don't know what exactly the community thinks is missing/lacking. My ideas about what is helpful is rarely the same as the git lists :) However, if someone pointed to one of the chapters I wrote and said "that would be great in the UM", I would happily convert it.

Scott