Re: [RFC PATCH] Add git quick reference

Jonas Fonseca [off-list ref] writes:

J. Bruce Fields [off-list ref] wrote Sun, Jun 03, 2007:

quoted

On Sat, Jun 02, 2007 at 08:24:23PM +0200, Jonas Fonseca wrote:

quoted

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.

quoted

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. :)

quoted

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.