From: Michael Witten Date: Sat, 02 May 2009 23:13:24 GMT Subject: Re: [doc] User Manual Suggestion Message-ID: In-Reply-To: <20090502211110.GC6135@atjola.homenet> 2009/5/2 Björn Steinbrink : >> 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.