From: Linus Torvalds Date: Wed, 15 Nov 2006 16:50:26 GMT Subject: Re: Missing features in git Message-ID: In-Reply-To: <20061115073546.GD5453@diana.vm.bytemark.co.uk> On Wed, 15 Nov 2006, Karl Hasselström wrote: > 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