Re: Announcement of Git wikibook
- From
Steven Walter <stevenrwalter@gmail.com>
- Date
- Oct 21, 2007, 03:09 UTC
- Message-ID
- <20071021030927.GA19450@dervierte>
- In-Reply-To
- <Pine.LNX.4.64.0710202232280.25221@racer.site>
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@gmail.com> Freedom is the freedom to say that 2 + 2 = 4 B2F1 0ECC E605 7321 E818 7A65 FC81 9777 DC28 9E8F