Forem Creators and Builders 🌱

Discussion on: Making Your Forem Work for You

Collapse
 
jeremyf profile image
Jeremy Friesen

I've spent some time in the tag logic, and let me clarify based on my understanding. There is one very significant number: 0. If your tag's "calculated points" drop below 0, that tag won't be in the "My Tags" list on the left. (See PR #16213 for even more gruesome discussion).

Further, if your tag's "calculated points" are less than 0 it's relevance factor in the feed will be lower. And as the calculated score gets larger it will have a higher relevance factor. That relevance factor will be between 0 (exclusive) and 1 (inclusive) and multipled against other factors. (See Articles::Feeds::WeightedQueryStra... for implementation details).

But what's the "calculated points?" This is where things get a bit fuzzy for me as I haven't dived to deep. But the "calculated points" are derived from the explicit points that you set and adjusted based on what you're writing and perhaps commenting on.

That is if you follow only two tags (let's say Ruby and Emacs each at 2) and write more posts and comment on posts that have Emacs but not Ruby, then your "calculated points" for Ruby will be lower than Emacs, and Emacs will be higher than 2 and Ruby would be lower than 2. I don't think that there will be too much drift such that you might cross the magic 0 threshold for calculated points.

Collapse
 
jeremyf profile image
Jeremy Friesen

Explicit points: what the user sets, it’s an unbounded number (except by the database)
Points: These flutter around the explicit points based on your interactions.

Relevance Factor: We map the explicit points to a number between 0 and 1 then multiple that factor times the other factors of articles. That's based on the current configuration of the feed.

Relevance Score: between 0 and 1. 0 won’t show in your relevant feed, closer to 1 means higher in the list.

Thread Thread
 
andypiper profile image
Andy Piper

This is all really useful to my understanding.

I guess the next question is whether this could be simplified or made more clear for end users. I wonder whether some form of slider control would be more or less helpful here.

Thread Thread
 
jennieocken profile image
Jennie Ocken (she/her)

Yes, this entire section can, and will, be made more simpler/clear for end users. It is not currently a place we are focusing our product development efforts but it is high on my list for our backlog. (one of our designers is already giving it a lot of unloving side eye).