Skip to content

docs: add scoring & ranking deep dive to recall docs#1317

Merged
nicoloboschi merged 1 commit intomainfrom
docs-scoring-ranking-deep-dive
Apr 29, 2026
Merged

docs: add scoring & ranking deep dive to recall docs#1317
nicoloboschi merged 1 commit intomainfrom
docs-scoring-ranking-deep-dive

Conversation

@nicoloboschi
Copy link
Copy Markdown
Collaborator

Summary

  • Adds a new Scoring & Ranking Deep Dive section to the recall retrieval docs
  • Documents the full pipeline: RRF fusion formula, cross-encoder reranking, combined scoring boosts (recency, temporal proximity, proof count), recall budget mapping, and graph scoring detail
  • Includes design rationale ("why") for each algorithm choice, drawn from code comments
  • Removes the now-redundant "Graph Retrieval Algorithms" section (only one algorithm exists)
  • Updates both docs/ and versioned_docs/version-0.5/

Test plan

  • Docs build passes in CI
  • Verify rendered page at Developer → Recall → Scoring & Ranking Deep Dive

Explains how the recall pipeline actually scores and ranks results:
RRF fusion formula, cross-encoder reranking, combined scoring boosts
(recency, temporal proximity, proof count), budget-to-pipeline mapping,
and graph scoring detail. Includes design rationale for each algorithm
choice (why RRF, why multiplicative boosts, why tanh for entities).
@nicoloboschi nicoloboschi merged commit 1a37ad1 into main Apr 29, 2026
1 of 2 checks passed
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