Skip to content

docs: Game Mechanics and Points Computation Math Specification (#216)#262

Merged
indresh404 merged 2 commits into
indresh404:mainfrom
nitishchaubeyy:docs/points-specification
Jun 3, 2026
Merged

docs: Game Mechanics and Points Computation Math Specification (#216)#262
indresh404 merged 2 commits into
indresh404:mainfrom
nitishchaubeyy:docs/points-specification

Conversation

@nitishchaubeyy
Copy link
Copy Markdown
Contributor

Description

Resolves #216 by introducing a highly detailed POINTS_SPEC.md document in the /docs directory. This creates complete transparency around how developers are ranked and how XP is dynamically distributed across the platform.

Key Additions:

  • GitRank Math: Formally documented the (Commits*2) + (PRs*5) + (Reviews*10) algorithmic weighting.
  • Streak & Decay Mechanics: Detailed the UTC timezone-agnostic boundaries and the flat +10 XP daily increment rules.
  • Total Aggregation & Tie-Breakers: Documented the master equation and the deterministic sorting fallback rules (Points -> Commits -> Username) introduced in recent updates.
  • Achievement Mapping: Clearly listed the exact threshold conditions required for users to unlock local profile badges.

Fixes #216

@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ranker-hub Ready Ready Preview, Comment Jun 3, 2026 2:57pm

@github-actions github-actions Bot added bug Something isn't working documentation Improvements or additions to documentation enhancement New feature or request frontend Frontend related changes (HTML/CSS/JS/React) gssoc GirlScript Summer of Code gssoc26 GirlScript Summer of Code 2026 nsoc NSoC NSoC'26 NSoC 2026 pending-review PR is pending review labels Jun 3, 2026
@indresh404 indresh404 merged commit f445c08 into indresh404:main Jun 3, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working documentation Improvements or additions to documentation enhancement New feature or request frontend Frontend related changes (HTML/CSS/JS/React) good first issue Good for newcomers gssoc GirlScript Summer of Code gssoc26 GirlScript Summer of Code 2026 level:intermediate level2 nsoc NSoC NSoC'26 NSoC 2026 pending-review PR is pending review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs]: Game Mechanics and Points Computation Math Specification

2 participants