Re: [doc] User Manual Suggestion
2009/5/2 Björn Steinbrink <B.Steinbrink@gmx.de>:
Show 12 quoted lines
>> > 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.
Michael Witten <mfwitten@gmail.com>