* Add internal tool to preview feed configs * Update app/services/articles/feeds/variant_query.rb |
||
|---|---|---|
| .. | ||
| lever_catalog_builder.rb | ||
| order_by_lever.rb | ||
| README.md | ||
| relevancy_lever.rb | ||
| variant_assembler.rb | ||
Feed Configuration
Welcome to the technical documentation of the Feed Configuration. It's structured as an index pointing you to related files.
Historical Documents
- The Articles::Feeds::WeightedQueryStrategy is the precursor to the more robust feed configuration.
- This post walked through the meaning of each of the initial relevancy levers.
In addition there are two code walk throughs explaining the pull requests that introduced the VariantQuery:
So You Want to Change the Relevancy Feed
The forem/forem#17406 pull request contains an example of configuring a VariantQuery You can also read the config/feed-variants/README.md for further context.
Understanding the Variant Query
In Diving into Dev's Relevancy Feed Builder we explained the conceptual implementation; providing a conceptual entity relationship and sequence diagrams.
The key thing to understand is as follows: We create a SQL statement
that calculates a relevancy_score for a given user and each article in the
Forem instance. The higher the article's relevancy_score, the closer that article will be to
the top of the feed.