"Scott Chacon" [off-list ref] writes:
On Fri, Jul 25, 2008 at 4:47 PM, Junio C Hamano [off-list ref] wrote:
quoted
...
I find a tabular list like this list easier to read if it were sorted like
this:
A D G
B E H
C F
...
I fixed the things you mentioned here, except for the list ordering,
only because I kinda think you big contributors should be at the top
there,...
If you are going to list 30 or so top contributors in 8 rows times 4
columns, because visually the columns are much more distinct than the
rows, it makes the result look more sorted. This is the same reasoning
hwo "git help --all" was fixed with 112d0ba (Make "git help" sort git
commands in columns, 2005-12-18).
By the way, I think this shows another issue with the "rest of us" list in
the lower half.
I have a mild suspicion that sorting that list in alphabetical order may
actually make it much better. It all depends on the purpose of that list,
though.
The purpose of the list would most likely not to find somebody with high
activity to contact for help (you would use the top list that is sorted by
the commit count for that kind of thing). It would primarily be to give
credit to everybody, and perhaps so that people on the contributor list
can point at their own name and say "I helped them", or find somebody else
they happen to know in the list.
When a contributor used to have 8 commits and then adds 2 commits, that
would move the name in the list by a dozen places or so with the current
set of contributors. It would be much easier to locate one's own name
among a huge list if the names are alphabetically sorted, not by commit
count. When more people start to contribute, your name does not move so
drastically. If you are Adam, you are likely to find yourself near the
beginning of the list, if you are Scott, you are likely to find yourself
near one fourth from the end of the list.
And for the "giving credit" purpose, I do not think truncating the list at
5 commits or less threshold, as suggested earlier and already done, makes
much sense, either.
As a contributer with a single commit I was happy to see myself appear
shortly on the list (yeah!). Ok, so I realize it is vanity and a little
silly... :-)
Junio C Hamano gitster-at-pobox.com |Lists| wrote:
I have a mild suspicion that sorting that list in alphabetical order may
actually make it much better. It all depends on the purpose of that list,
though.
To me it makes sense to sort the entire list according to commits. Its
still easy to find anybody with search, and I find it appropriate that I
be towards the end. The commit sorting encourages me to move up the
list! :-D
And for the "giving credit" purpose, I do not think truncating the list at
5 commits or less threshold, as suggested earlier and already done, makes
much sense, either.
And why truncate the list? I'd personally like to be back on the list
(vanity! - but true), bandwidth is relatively cheap, and there is
nothing below the list. I also think it makes the community look healty
and encourages contribution to see how many others contribute.
Peter
--
Peter Valdemar Mørch
http://www.morch.com
On Sat, Jul 26, 2008 at 10:10:32AM -0700, Junio C Hamano wrote:
"Scott Chacon" [off-list ref] writes:
quoted
On Fri, Jul 25, 2008 at 4:47 PM, Junio C Hamano [off-list ref] wrote:
quoted
...
I find a tabular list like this list easier to read if it were sorted like
this:
A D G
B E H
C F
...
I fixed the things you mentioned here, except for the list ordering,
only because I kinda think you big contributors should be at the top
there,...
If you are going to list 30 or so top contributors in 8 rows times 4
columns, because visually the columns are much more distinct than the
rows, it makes the result look more sorted. This is the same reasoning
hwo "git help --all" was fixed with 112d0ba (Make "git help" sort git
commands in columns, 2005-12-18).
Actually, this is strange for me: I would never think about reading git
help --all by rows, and I would never think about reading the authors
list by columns! It's difficult for me to point out why, possibly
because the authors list has less items per row and the items are longer
(and multi-word), but that's just a speculation. Maybe cultural
background (Japanese books are written in columns, right?) plays some
role too, I don't know.
The purpose of the list would most likely not to find somebody with high
activity to contact for help (you would use the top list that is sorted by
the commit count for that kind of thing). It would primarily be to give
credit to everybody, and perhaps so that people on the contributor list
can point at their own name and say "I helped them", or find somebody else
they happen to know in the list.
When a contributor used to have 8 commits and then adds 2 commits, that
would move the name in the list by a dozen places or so with the current
set of contributors. It would be much easier to locate one's own name
among a huge list if the names are alphabetically sorted, not by commit
count. When more people start to contribute, your name does not move so
drastically. If you are Adam, you are likely to find yourself near the
beginning of the list, if you are Scott, you are likely to find yourself
near one fourth from the end of the list.
I don't think locating is any issue; the find function of browser is
very easy to use nowadays. I guess the purpose of the list would be
to show "I helped them this much" (i.e. "I'm high on the list"). I think
this would actually motivate contributors to move up in the ladder -
people are competitive; you might get wary about this kind of
motivation, but I believe that it is no bad thing, inherently. Heck, I
admit it does motivate even me a little, safely in the "Primary Authors"
section. :-) (These guys with their tools merged into git have unfair
advantage! You should add up also, uh, git-homepage, cogito and, um...
repo.git! *baby cry*</vanity>)
And for the "giving credit" purpose, I do not think truncating the list at
5 commits or less threshold, as suggested earlier and already done, makes
much sense, either.
The point here is that the list is awfully long and also can contain
a lot of duplicates or people with broken unicode, etc. - it gets hard
to maintain, and it makes the about page too long. I would be of course
fine with a tiny link at the bottom "(show all contributors)".
--
Petr "Pasky" Baudis
As in certain cults it is possible to kill a process if you know
its true name. -- Ken Thompson and Dennis M. Ritchie