From: Johannes Schindelin Date: Wed, 09 May 2007 09:33:58 GMT Subject: Re: [PATCH] Add a birdview-on-the-source-code section to the user manual Message-ID: In-Reply-To: <7v4pmmzivz.fsf@assigned-by-dhcp.cox.net> Hi, On Tue, 8 May 2007, Junio C Hamano wrote: > Junio C Hamano writes: > > > "J. Bruce Fields" writes: > > > >> The organization of the next bit is slightly confusing: we're set up > >> to expect a longer lecture on the revision walker, but instead > >> there's just the historical note on git-rev-list, a mention of > >> 'revision.c', 'revision.h', and 'struct rev_info', and then it > >> rapidly digresses into discussing builtins. > > > > I had the same impression. > > > > I was meaning to write a "code walkthru for git hackers and wannabes" > > with target audience quite different from the user-manual. My idea of > > which areas to cover in what order seems to match with what Johannes > > started. > > Having said that, I do not think the patch belongs to the "git USER'S > manual". It is a very good introductory material for a separate "git > hackers manual", though. That is what I was referring to when I mentioned "no outcry". Bruce said that he liked the idea to have something like that in the USER's manual. And I have to agree: There might be enough room to actually go and write a Git hacker's manual, but IMHO that takes a lot of time which has to be found at first. And even if we actually have such a hacker's manual one day, this "sneak preview" in the user's manual does not hurt, but could actually entice people to read that manual, too. Ciao, Dscho