Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Hot Posts #145

Merged
merged 4 commits into from
Feb 16, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions docs/basics/polkaverse/HotPosts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
id: hot-posts
title: Hot Posts Algorithm
description: Hot Posts on PolkaVerse receive extra visibility after being frequently engaged with by users on the network.
keywords: [Subsocial, PolkaVerse, Posts, Hot, Content, Algorithm, Polkadot]
---

PolkaVerse has a [Hot Posts](https://polkaverse.com/?tab=posts&type=hot&date=week) tab,
where users can see new posts that have received lots of engagement recently.
This serves as an avenue for lesser known creators to have access to more eyeballs if one of their posts performs exceptionally well.

## The Algorithm

The Hot Posts feed is based on the Normalized Ranked Posts List, which is determined from the Original Ranked Posts List. Let's look at each of these.

### The Original Ranked Posts List

When a new post is created, it is added to the list with an initial value based on how many SUB the post creator has locked.

When a post is liked, it receives 5 points, and when high quality comments (those that make it past the spam filter) are created on a post,
the post receives 20 points.

The rewards that a post earns also increase its rating.

At the end of the day, the scores of every post in the Original Ranked Posts List, that were posted within the last week, are reduced by 10%.
This decay will cause older posts to slowly drop out of Hot Posts.

The exact formulas used for the ranking calculations are subject to frequent change as the platforms develops,
which is why they are not listed here, as they may change frequently.

### The Normalized Ranked Posts List

In some situations, using only the Original Ranked Posts List could result in multiple posts from the same creator being shown together.
To avoid this, the Normalized Ranked Posts List is used.

This list takes the Original Ranked Posts List and re-orders it so that posts from the same creator cannot be shown within 2-4 posts of each other.
The list regenerates every five minutes to keep it up-to-date with the latest Original Ranked Posts List.

The Normalized Ranked Posts List is fed directly to the PolkaVerse UI to display on the [Hot Posts](https://polkaverse.com/?tab=posts&type=hot&date=week) tab.


3 changes: 3 additions & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,9 @@ module.exports = {
'basics/tokenomics/token-distribution',
'basics/tokenomics/treasury',
],
PolkaVerse: [
'basics/polkaverse/hot-posts',
],
},
'basics/content-staking/content-staking',
'basics/faq/overview',
Expand Down
Loading