From: Wincent Colaiuta <win@wincent.com>
Date: Sun, 21 Oct 2007 09:10:24 GMT
Subject: Re: Announcement of Git wikibook
Message-ID: <F430333B-B29B-4992-9474-0E87006CBA77@wincent.com>
In-Reply-To: <20071021030927.GA19450@dervierte>

El 21/10/2007, a las 5:09, Steven Walter escribió:

> On Sat, Oct 20, 2007 at 10:34:34PM +0100, Johannes Schindelin wrote:
>> I am torn.  On one side I like the Wiki approach.  On the other  
>> hand, the
>> Wiki will get less review by git oldtimers, whereas the patches to
>> user-manual are usually reviewed as thoroughly as the code patches.
>
> No offense, but review by old timers can be both a blessing and a  
> curse.
> Well, it's not the "review" that is so much a problem as the  
> "editorial
> control."  In my opinion (and I believe this is what the original  
> poster
> was saying), the official Git User Manual focuses more on technical
> issues and less on introducing git to a new user.

But it's not an "intro", it's a user manual. That means it's supposed  
to be a comprehensive, in-depth treatment of just about everything.  
The technical content is a good thing; it's supposed to be the  
document you turn to when you want to move beyond superficial use to  
genuine, in-depth understanding.

There are other documents with the goal of "introducing git to the  
new user", grouped together here:

<http://git.or.cz/course/index.html>

And also under the "Documentation" heading on the Git home page:

<http://git.or.cz/>

Those are probably the articles that should be worked on and  
augmented if you care about introducing things to a newbie.

Cheers,
Wincent