From: Junio C Hamano Date: Wed, 06 Jun 2007 20:36:06 GMT Subject: Re: [RFC PATCH] Add git quick reference Message-ID: <7vps48zuq1.fsf@assigned-by-dhcp.cox.net> In-Reply-To: <20070604184546.GA27088@diku.dk> Jonas Fonseca writes: > J. Bruce Fields wrote Sun, Jun 03, 2007: >> On Sat, Jun 02, 2007 at 08:24:23PM +0200, Jonas Fonseca wrote: >> > It attempts to list some of the most commonly used commands, which should >> > give new users an idea of how to get started. >> > >> > Available both as a manpage (generated via a script) and HTML page. >> >> We have a "git quick start" here: >> >> http://www.kernel.org/pub/software/scm/git/docs/user-manual.html#git-quick-start >> >> and there's one on the wiki: >> >> http://git.or.cz/gitwiki/QuickStart >> >> I think the one in the manual tries to follow the organization of the >> manual more closely. > > I like the manual version best. However, it is not as "visually" clean > and simple as I would like, but perhaps this sort of "use case" approach > is better. > >> I haven't tried to compare those two recently, or to compare yours to >> either of them. If you could compare and suggest any improvements, >> that'd be helpful. > > I will see what I can do when I get the time and courage. :) > >> I like your name better ("quick reference" as opposed to "quick start"). > > Yes, "quick start" suggest (at least to me) that it is a tutorial and it > seems far from that. When I started the "everyday" document, I wanted to make it a cheat sheet usable by people who are not so familiar with the workflow. The "quick reference" would be good for people who want a cheat sheet without need for workflow description.