Re: Announcement of Git wikibook

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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.

This makes perfect sense given that it's edited by oldtimers, who are
neither inclined nor particularly suited to explaining git to newbies;
they have simply forgotten what it was like for these concepts to be
foreign.  They eat SHA1 hashes for breakfast and dream about index
files.  And that's great :)

I don't think the wikibook should try to duplicate the Git User Manual.
That would be a wasted effort.  But there is a niche to be filled in git
documentation, particularly in regard to specific workflows and git best
practices.  With git, TMTOWTDI.  It's quite difficult for a newbie to
know which of those ways will come back and bite them in the ass down the
road.

Of course, it is a wikibook, so it will go where it goes.  I for one am
glad to see this project started.
-- 
-Steven Walter <stevenrwalter@xxxxxxxxx>
Freedom is the freedom to say that 2 + 2 = 4
B2F1 0ECC E605 7321 E818  7A65 FC81 9777 DC28 9E8F 

Attachment: signature.asc
Description: Digital signature


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux