git/list[1] front-page[2] threads[3] people[4] search[5] about
 

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

From
Junio C Hamano <gitster@pobox.com>
Date
May 21, 2015, 17:15 UTC
Message-ID
<xmqqsiapkg29.fsf@gitster.dls.corp.google.com>
In-Reply-To
<CAPig+cT65MpPYaE4BxajMNU2N=rf6QQzsxDsc7fV-_GMPVcdhw@mail.gmail.com>
Eric Sunshine <sunshine@sunshineco.com> writes:
Show 5 quoted lines
> 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 labels are a simple
> organizational aid.

I am not so sure about that. For one thing, the groups are not exhaustive enumeration of all the workflow elements, but just a list of the more common ones. I think the target audience of this round, which is different from the target audience of the "alphabetical list", range from those who do not have a clue where to start and do not know how their work that revolves around use of Git could be structured. And "not yet being familiar with the way how things are often done with Git" is certainly different from them being "not intelligent enough".

More experienced people can do without the explanation, or without grouping for that matter. We are not the target audiences.

> Anyhow, it's just a minor observation, and it's something people can
> argue later if they feel strongly about it, so I don't think it should
> hold up this patch series.
Yeah, I agree with that.
Previous: Eric Sunshine
Message 13 of 13 in “group common commands by theme”
  1. 0/5 group common commands by themeSébastien Guimmara, May 21, 2015
  2. 1/5 command-list: prepare machinery for upcoming "common groups" sectionSébastien Guimmara, May 21, 2015
  3. Eric SunshineMay 21, 2015
  4. Sébastien GuimmaraMay 21, 2015
  5. Eric SunshineMay 21, 2015
  6. 2/5 command-list.txt: add the common groups blockSébastien Guimmara, May 21, 2015
  7. 3/5 generate-cmdlist: parse common group commandsSébastien Guimmara, May 21, 2015
  8. 4/5 command-list.txt: drop the "common" tagSébastien Guimmara, May 21, 2015
  9. 5/5 help: respect new common command groupingSébastien Guimmara, May 21, 2015
  10. Eric SunshineMay 21, 2015
  11. Junio C HamanoMay 21, 2015
  12. Eric SunshineMay 21, 2015
  13. Junio C HamanoMay 21, 2015

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.