Re: Suggestion: doc restructuring

Andreas Ericsson [off-list ref] writes:

Junio C Hamano wrote:

quoted

Johannes Schindelin [off-list ref] writes:

quoted

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.