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 >

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

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

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

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

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,

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

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.