Re: [RFC PATCH] Add git quick reference
- From
Junio C Hamano <junkio@cox.net>
- Date
- Jun 6, 2007, 20:36 UTC
- Message-ID
- <7vps48zuq1.fsf@assigned-by-dhcp.cox.net>
- In-Reply-To
- <20070604184546.GA27088@diku.dk>
Jonas Fonseca <fonseca@diku.dk> writes:
Show 32 quoted lines
> J. Bruce Fields <bfields@fieldses.org> 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.