Change the ranking/level system

[LucBerge]

I just discovered your repo and it is exactly what I need to create my user repo and user readme. Thank you for the amazing work you are doing here !

Is your feature request related to a problem? Please describe.

I'm surprised by the ranking system currently used:

• B+ everyone
• A++ top 60%
• A+ top 45%
• S top 25%
• S+ top 1%

Most of the people who will see a github stats card like this won't understand the ranking system or will not understand it correctly. For me, A+ means really good user (or code quality) if you consider the ABCDEF ranking system.

To actually understand your ranking system, you need to click on the card, start reading the readme and find a little note explaining it.

The ranking label on the card must be obvious for anybody reading the card, whatever the job, nationality, education or culture.

Describe the solution you'd like

Proposing my own ranking system won't be the ideal solution too. It will have a global impact on everybody, so I think the community itself must debate to find the right ranking system !

Describe alternatives you've considered

Instead of a ranking system, you could just display the user rank in percentage:

Additional context

If you think this issue is relevant, consider pinning it so everybody can contribute.

[rickstaa]

@LucBerge Thanks for your feature request. I agree with you that the ranking system is weird, and I think we are not the only ones since there have been multiple proposals and PRs open that try to improve the ranking:

• Change the ranking/level system #2265
• Yet Another Proposal for Calculate Ranks #1560
• Suggestion for more ranks or a different raking system. #1579
• Improve ranking system #455
• Ranking System v1 #960
• Ranking System v2 #1186

I think three things can be improved about the ranking:

• Switch to a more commonly used grading system (i.e. A-F, A+ to F or % based).
• Show top-users percentage on hover (see Grade description in the report card. #2157).
• Improve the rank calculation (see Missing term in calculation of TOTAL_VALUES. #2116 and Ranking System v2 #1186).

@anuraghazra I think we can merge #2116 and #1186 and switch to the A-F or A+ to F ranking system?

[rickstaa]

This is one of our most requested features, so I have looked at it (see #1935). I, however, would like some feedback from @anuraghazra before merging #2116 and #1186.

[LucBerge]

In this issue, I'm only talking about the displayed values, I'm not questionning the model behind.

You first have to deal with the computation method before moving to the displayed values.

For now, the propositions are:

• Yet Another Proposal for Calculate Ranks #1560: S+, S, A, B, C, D, E...
• Suggestion for more ranks or a different raking system. #1579: lvl 1, lvl 2, lvl 3, lvl 4...
• Change the ranking/level system #2265: % based
• US ranking system: A+, A, B+, B, C+, C...

What else do we have ?

[rickstaa]

@LucBerge I think the other ones would be the US ranking systems (see https://everydayeducation.com/blogs/news/grading-systems#:~:text=The%20most%20commonly%20used%20grading,100%20instead%20of%20letter%20grades).

• A-F.
• A+-F

I prefer these systems while showing the % based results on hover (see #2157), but I might be biased let's see what @anuraghazra thinks.

[rickstaa]

We also have the Japanese, which I think the current ranking is based on (see https://en.wikipedia.org/wiki/Academic_grading_in_Japan). Since only the S+ is confusing for me, I think this one is also fine, but I think fewer people are familiar with that ranking system. So my vote still goes to the US-based ranking systems If we want to use letters.

[LucBerge]

Well, I didn't know it was Japanese until now...

[rickstaa]

Well, I didn't know it was Japanese until now...

Same for me. I looked it up some months ago. It was the closest one I could find to the one GRS is using. 🤓 Maybe @anuraghazra can elaborate on which ranking system he based the GRS ranks on.

[francois-rozet]

Hello, I don't think the A-F system is a good idea. C, D and F are associated to a bad grade so it would be like "shaming" new devs because they have little contributions.

[ZjzMisaka]

Maybe we can refer to the game rank, after all the developers spent a lot of time researching this

[rickstaa]

Hello, I don't think the A-F system is a good idea. C, D and F are associated to a bad grade so it would be like "shaming" new devs because they have little contributions.

Good point we don't want that 😅!

[rickstaa]

Maybe we can refer to the game rank after all the developers spent a lot of time researching this

@ZjzMisaka Thanks for your input. That ranking system looks good to me very clear. It also is very close to the Japanese game ranking system @anuraghazra is currently using. I think if we extend the current ranking system to your suggestion and add a hover that explains the score, we should be good to go (see #2157).

[rickstaa]

@ZjzMisaka, I think your suggestion is similar to the suggestion given in #1560. I would go for your version since it doesn't include the F grade and is more commonly used. Let's see what @anuraghazra thinks.