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:

• Introducing the concepts
• Walk through of code connecting concepts to production

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.