Re: [doc] User Manual Suggestion

["Björn Steinbrink" <B.Steinbrink@gmx.de>]

On 2009.05.02 18:13:24 -0500, Michael Witten wrote:
> 2009/5/2 Björn Steinbrink <B.Steinbrink@gmx.de>:
> >> 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'm not opposed to re-ordering stuff. Though I often think that having
commands and concepts "together" is better.  Maybe we just need that
twice? Once the plain data model, and once a "hands on" version where
the effects of the commands are described in terms of the data model.

The former "sucks" for those that want to just "dive in" (but might
still be happy to get told what their actions do), the latter sucks when
you just want to look something up.

Hm?

Björn