On Wed, 15 Nov 2006, Karl Hasselström wrote: > On 2006-11-14 16:38:00 -0500, linux@xxxxxxxxxxx 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