Skip to content

Add ranking score pipeline doc - #78

Open
nS-101 wants to merge 1 commit into
xai-org:mainfrom
nS-101:docs/ranking-score-pipeline
Open

Add ranking score pipeline doc#78
nS-101 wants to merge 1 commit into
xai-org:mainfrom
nS-101:docs/ranking-score-pipeline

Conversation

@nS-101

@nS-101 nS-101 commented Aug 20, 2026

Copy link
Copy Markdown

Summary

  • Adds docs/RANKING_SCORE_PIPELINE.md, a reference doc walking through the four scoring stages a candidate goes through after Phoenix predicts its action probabilities: base weighted score, author cold-start, author diversity decay, and the out-of-network discount.
  • Fills in the formulas, default parameter values, and worked numeric examples that the README's Scoring and Ranking section intentionally summarizes at a high level, with citations to the relevant ranking_scorer.rs / author_cold_start.rs line numbers.
  • Includes a note on slate_context/k on cached (paginated) requests: scoring always recomputes fresh for correctness, but the slate_context field written back onto the output candidate intentionally keeps the originally-cached value (verified against the existing recomputes_contexts_for_scoring_on_cached_posts test) for a stable signal downstream to vm-ranker.

This is documentation only — no code changes.

Test plan

  • N/A (docs-only change, no code touched)

Documents the four post-Phoenix scoring stages (base weighted score,
author cold-start, author diversity decay, out-of-network discount)
with formulas, default param values, and worked examples, plus a note
on why slate_context intentionally stays stale for cached requests.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant