Re: Suggestion: doc restructuring
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Jul 21, 2008, 16:22 UTC
- Message-ID
- <7viquztdfj.fsf@gitster.siamese.dyndns.org>
- In-Reply-To
- <48842FA8.5070309@op5.se>
Andreas Ericsson <ae@op5.se> writes:
Show 27 quoted lines
> 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.