From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 21 Jul 2008 16:22:24 GMT
Subject: Re: Suggestion: doc restructuring
Message-ID: <7viquztdfj.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <48842FA8.5070309@op5.se>

Andreas Ericsson <ae@op5.se> writes:

> Junio C Hamano wrote:
>> Johannes Schindelin <Johannes.Schindelin@gmx.de> writes:
>>
>>> So what I really would like is this: leave the plumbing pages as
>>> they are, but enhance those pages that users (especially new ones)
>>> are likely to see most often.
>>
>> Regarding the original "do we want to ever teach plumbing to new users?"
>> issue, I suspect that, with sufficient enhancement to Porcelain, we might
>> be able to reach a point where end users can work without ever touching a
>> single plumbing command at all.
>>
>> 	Side note, that was why I suggested us to first think about use
>> 	cases in our every day work that we still need to resort to the
>> 	plumbing, so that we can identify what that enhancement would
>> 	consist of.
>>
>
> Half a year or so ago, there were some mailings to the list along the lines
> of "what git commands do you use?", using the bash history and a shell
> oneliner to dig out some crude intel. Here's mine:
> cat ~/.bash_history | grep ^git | awk '{ print $2 }' | grep -v '^--' | sort | uniq --count | sort -nr
>     29 status
>     26 diff
>     19 show
>     17 log
> ...

While that stat might be interesting to look at, it does not have 
much relevance to what I was suggesting.