Re: multi-project repos (was Re: Cleaning up git user-interface

Hi,

On Fri, 17 Nov 2006, linux@horizon.com wrote:

How do you explain the point of an electric screwdriver to someone who's 
never seen a screw?  He'll think it's a silly way to wind up yarn.

I show him how to use it. And that's actually a fine analogy: While the 
principle of a screw is quite clever, working with it -- even with an 
electric screwdriver -- is easy. And the most important part: I never read 
instructions on how to use it. I saw somebody use it and -- voila! -- I 
can use it myself.

I'll be the first to explain that the git docs have some major problems. 
"git show" is a really useful command.  It has a zillion options to do 
cool things.  Have you read the man page?

I think that the importance of documentation is overrated. Users have come 
to expect to use programs without reading a manual. DWIM comes to mind.

Ciao,