On Thu, 2007-10-25 at 01:48 +0200, Jakub Narebski wrote:This asymmetry is also part of what makes Git hard to learn at first. There is a lot of new terminology to learn: refs remotes fast-forwarding rebasing origin master HEAD (which is not quite the same as good old CVS's HEAD) etc. The solution is not, "have a good glossary" (which is needed, anyway), but to make the documentation introduce those concepts at the right time, instead of being chock-full of them from the beginning :) Carl Worth's git-ification of the Mercurial book chapter is very nice in this regard; it doesn't dump all the terminology on you, but rather takes its time to introduce each concept when you are ready to know about it [1]. It's kind of sad that the first thing "man git-push" tells you is this: git-push - Update remote refs along with associated objects So you go, "refs? associated objects? whaaaaaat?" :) Imagine someone learning the GIMP a few versions ago. "I want to make this photo sharper". You go to the Filters/Enhance menu and you see Laplace Sobel Sharpen Unsharp mask All of those sharpen the image. Which one do you pick? [1] http://cworth.org/hgbook-git/ Federico - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
| Glauber de Oliveira Costa | [PATCH 5/25] [PATCH] native versions for system.h functions |
| Bart Van Assche | Integration of SCST in the mainstream Linux kernel |
| Chuck Ebbert | Why do so many machines need "noapic"? |
| Robert Hancock | Re: Disk spin down issue on shut down/suspend to disk |
git: | |
| David Kastrup | Empty directories... |
| Sean | Re: git and time |
| Martin Langhoff | Re: [PATCH 4/5] Overhaul of changeset application |
| Michael Witten | Re: Proposed git mv behavioral change |
| Bertram Scharpf | First install: Grub doesn't find partitions |
| Richard Stallman | Real men don't attack straw men |
| Tony Abernethy | Re: Important OpenBSD errata |
| Nuno Magalhães | Does CUPS depend on X?! [oB newbie] |
| hooanon05 | [PATCH 62/67] aufs magic sysrq handler |
| Avi Kivity | Re: [RFC] VM: I have a dream... |
| Alasdair G Kergon | Re: [dm-devel] Re: [PATCH 3/3] Add timeout feature |
| Miklos Szeredi | [PATCH] update ctime and mtime for mmaped write |
