app/flatpages/help/top_packages.md

   1 title: Top Packages Algorithm
   2
   3 ## Score
   4
   5 A package's score is currently equal to a pseudo rolling average of downloads.
   6 In the future, a package will also gain score through reviews.
   7
   8 ## Pseudo rolling average of downloads
   9
  10 Every package loses 5% of its score every day, and will gain 1 score for each
  11 unique download.
  12
  13 This metric aims to be roughly equivalent to the average downloads.
  14
  15 ## Seeded using a legacy heuristic
  16
  17 The scoring system was seeded (ie: the scores were initially set to) 20% of an
  18 arbitrary legacy heuristic that was previously used to rank packages.
  19
  20 This legacy heuristic is as follows:
  21
  22         forum_score = views / max(years_since_creation, 2 weeks) + 80*clamp(months, 0.5, 6)
  23         forum_bonus = views + posts
  24
  25         multiplier = 1
  26         if no screenshot:
  27                 multiplier *= 0.8
  28
  29         score = multiplier * (max(downloads, forum_score * 0.6) + forum_bonus)
  30
  31 As said, this legacy score is no longer used when ranking mods.
  32 It was only used to provide an initial score for the rolling average,
  33 which was 20% of the above value.
  34
  35 ## Manual adjustments
  36
  37 The admin occasionally reduces all packages by a set percentage to speed up
  38 convergence. Convergence is when
  39
  40 ## Transparency and Feedback
  41
  42 You can see all scores using the [scores REST API](/api/scores/), or by
  43 using the [Prometheus metrics](/help/metrics/) endpoint.
  44
  45 Consider [suggesting improvements](https://github.com/minetest/contentdb/issues/new?assignees=&labels=Policy&template=policy.md&title=).