From: Michael Witten Date: Sun, 03 May 2009 01:10:14 GMT Subject: Re: [doc] User Manual Suggestion Message-ID: In-Reply-To: <20090502233232.GD6135@atjola.homenet> 2009/5/2 Björn Steinbrink : >> > 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.