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

From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Nov 17, 2006, 10:02 UTC
Message-ID: <Pine.LNX.4.63.0611171058190.13772@wbgn013.biozentrum.uni-wuerzburg.de>
In-Reply-To: <20061117051157.27896.qmail@science.horizon.com>

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,