Re: Missing features in git

From: Linus Torvalds <torvalds@osdl.org>
Date: Nov 15, 2006, 16:50 UTC
Message-ID: <Pine.LNX.4.64.0611150847400.3349@woody.osdl.org>
In-Reply-To: <20061115073546.GD5453@diana.vm.bytemark.co.uk>

On Wed, 15 Nov 2006, Karl Hasselström wrote:

Show 10 quoted lines

> On 2006-11-14 16:38:00 -0500, linux@horizon.com wrote:
> 
> > It also removes a paragraph of excuses from some "using git" docs
> > I'm writing. It's a lot easier to explain why you can't commit if
> > you're not on a branch than to explain why you can't not be on a
> > branch.
> 
> This is precisely why writing documentation is such a good idea: It is
> in many cases easier to fix the warts than finding a pedagogical way
> to explain them. :-)

Heh. Pretty much all of the early git plumbing came about when I started to try to demonstrate git to others, and wrote some of the early tutorials. So yeah, trying to explain something to others (whether by documentation or through examples) is a good way to show what has bad interfaces.

Even if it's easy to use for yourself (I had my own scripts to do everything _I_ wanted to do), trying to explain why something is done some way to somebody who doesn't know the internals is always a good exercise.

		Linus