Re: de-alphabetizing the documentation

2018-08-13 Thread Junio C Hamano
frede...@ofb.net writes: > Hi Jonathan and Git developers, > > I poked around today and figured out how to reorder the command > listings in the manual page, they are taken from git/command-list.txt > so I just reorder the lines in that file (after disabling sorting in > git/Documentation/cmd-list

Re: de-alphabetizing the documentation

2018-08-10 Thread frederik
Hi Jonathan and Git developers, I poked around today and figured out how to reorder the command listings in the manual page, they are taken from git/command-list.txt so I just reorder the lines in that file (after disabling sorting in git/Documentation/cmd-list.perl). I haven't reordered the whol

Re: de-alphabetizing the documentation

2018-07-24 Thread Jonathan Nieder
Hi, frede...@ofb.net wrote: > Next week I should have time to send you a patch with the manual page > reordered... Yay! > although, unless you have a special 'diff' which can > detect when text has been moved from one place to another, I'm > guessing it would take you even longer

Re: de-alphabetizing the documentation

2018-07-24 Thread frederik
Hello Jonathan, Thank you for replying to me earlier. I just wanted to follow up on this thread. Did you decide not to go with my proposal? Next week I should have time to send you a patch with the manual page reordered... although, unless you have a special 'diff' which can detect when text has

Re: de-alphabetizing the documentation

2018-07-07 Thread frederik
Hi Jonathan, If it's really just a matter of needing someone with a newcomer's perspective, then I'd be happy to look over the ordering of the git subcommands. You can run the command I provided to glean the frequency of each subcommand from your shell history, I'll look over the output and see if

Re: de-alphabetizing the documentation

2018-07-06 Thread Theodore Y. Ts'o
On Fri, Jul 06, 2018 at 04:21:47PM -0700, frede...@ofb.net wrote: > I don't think that it's really important to find a "best" ordering for > commands or glossary terms; it's more a matter of finding someone who > is willing to take responsibility for choosing a reasonable ordering. > Presumably the

Re: de-alphabetizing the documentation

2018-07-06 Thread Jonathan Nieder
Hi, Frederick Eaton wrote: > Unfortunately my contribution will have to be limited for the > moment to making this suggestion, as I am extraordinarily busy. I hope > it will not be too burdensome to add this item to your TODO list and > keep it there until a willing volunteer comes along.

Re: de-alphabetizing the documentation

2018-07-06 Thread frederik
Thank you Jonathan for signaling your willingness to adopt the documentation philosophy I suggested. That's a quite valuable first step. Unfortunately my contribution will have to be limited for the moment to making this suggestion, as I am extraordinarily busy. I hope it will not be too burdensome

Re: de-alphabetizing the documentation

2018-07-06 Thread Eric Sunshine
On Fri, Jul 06, 2018 at 02:16:00PM -0700, Jonathan Nieder wrote: > Frederick Eaton wrote: > > I wonder if someone familiar with Git could list the commands in an > > order which makes more sense for learning, for example in the order in > > which they were invented by Git developers, > > Alas, the

Re: de-alphabetizing the documentation

2018-07-06 Thread Jonathan Nieder
Jonathan Nieder wrote: > Ideas? If you start with a proposal, we're happy to help refine it. > People in the #git channel on irc.freenode.net (wechat.freenode.net) > might also be useful for inspiration in coming up with a proposal. I meant to link to webchat.freenode.net. But https://kiwiirc.c

Re: de-alphabetizing the documentation

2018-07-06 Thread Jonathan Nieder
Hi Frederick, Frederick Eaton wrote: > I am trying to learn how to use Git but I've been put off by not > knowing where to start. I would like to start with the 'git' man page, > but it lists the Git subcommands in alphabetical order, rather than in > an order which would be useful for learners.

de-alphabetizing the documentation

2018-07-06 Thread frederik
Dear Git Developers, I am trying to learn how to use Git but I've been put off by not knowing where to start. I would like to start with the 'git' man page, but it lists the Git subcommands in alphabetical order, rather than in an order which would be useful for learners. For example, I'm not sure