[PATCH v10 5/5] help: respect new common command grouping

2015-05-21 Thread Sébastien Guimmara
'git help' shows common commands in alphabetical order: The most commonly used git commands are: addAdd file contents to the index bisect Find by binary search the change that introduced a bug branch List, create, or delete branches checkout Checkout a branch or

Re: [PATCH v10 5/5] help: respect new common command grouping

2015-05-21 Thread Eric Sunshine
On Thu, May 21, 2015 at 9:13 AM, Sébastien Guimmara sebastien.guimm...@gmail.com wrote: 'git help' shows common commands in alphabetical order: [...] without any indication of how commands relate to high-level concepts or each other. Revise the output to explain their relationship with the

Re: [PATCH v10 5/5] help: respect new common command grouping

2015-05-21 Thread Eric Sunshine
On Thu, May 21, 2015 at 12:16 PM, Junio C Hamano gits...@pobox.com wrote: Eric Sunshine sunsh...@sunshineco.com writes: + puts(_(These are common Git commands used in various situations:)); The clause in various situations is quite nebulous and thus adds no substance. FWIW I view

Re: [PATCH v10 5/5] help: respect new common command grouping

2015-05-21 Thread Junio C Hamano
Eric Sunshine sunsh...@sunshineco.com writes: + + puts(_(These are common Git commands used in various situations:)); The clause in various situations is quite nebulous and thus adds no substance. FWIW I view the latter half of that sentence as explaining the group labels which we did

Re: [PATCH v10 5/5] help: respect new common command grouping

2015-05-21 Thread Junio C Hamano
Eric Sunshine sunsh...@sunshineco.com writes: Hmm, but is it necessary to explain the group labels in the first place? The help output (group labels and all) seems self-explanatory already, and one would expect (hope) that readers are intelligent enough to understand implicitly that the group