2009/5/2 Björn Steinbrink <B.Steinbrink@xxxxxx>:
>> > 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.
Indeed. I think the key is to split up the documentation for these 2 paths.
http://marc.info/?l=git&m=124058631814726&w=2
The mixing of the 2 is what makes everyone unhappy.
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html