Re: [doc] User Manual Suggestion

From: Michael Witten <mfwitten@gmail.com>
Date: May 2, 2009, 23:13 UTC
Message-ID: <b4087cc50905021613j1d269757g8c599b484208c188@mail.gmail.com>
In-Reply-To: <20090502211110.GC6135@atjola.homenet>

2009/5/2 Björn Steinbrink <B.Steinbrink@gmx.de>:

Show 10 quoted lines

>> In any case, I *think* my point is that it's important to understand
>> that git uses content addressing; at first I was emphatic about the
>> idea of 'addressing', so I went with pointer terminology (which works
>> quite well, in my opinion). However, I think the 'content' part is
>> more important, which is why 'object hash' is loads better than
>> 'object name' or 'object id'. Also, at least the documentation could
>> say that 'objects are addressed by their hashes', which says a whole
>> lot in one quick sentence about how git works.
>
> Hm, like chapter 7 "Git concepts"?

That's exactly the problem. It should be in chapter 0.

I also dislike the use of 'name' rather than 'hash'; a name is something provided by the user, but a hash is something computed. The use of sha[-]1 is even more egregious.