Skip to content

Blog (draft): Hybrid search ranking — Part 1 of 2 - #3652

Draft
g-despot wants to merge 2 commits into
mainfrom
blog/search-result-quality-part-1
Draft

Blog (draft): Hybrid search ranking — Part 1 of 2#3652
g-despot wants to merge 2 commits into
mainfrom
blog/search-result-quality-part-1

Conversation

@g-despot

@g-despot g-despot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Part 1 of a 2-part "Search result quality & ordering" series

A practical, runnable tour of Weaviate's query-time ranking dials, threaded through a documentation / RAG DocChunk example (chunked pages, near-duplicates, stale versions — "relevant-ish but wrong order"):

  • Hybrid alpha — the vector-vs-keyword weight (default 0.75), with an alpha-sweep snippet + a compact BM25 sidebar (per-property AND gotcha).
  • FusionrelativeScoreFusion (the server default) vs. rankedFusion (RRF, k=60 hardcoded); when to pick which.
  • Reranking — the six reranker modules; the key teaching that a reranker reorders only the retrieved page, so over-fetch first.
  • Boost API — soft, never-excludes rescoring; blend a recency decay + current-version lift.
  • A combined hybrid → rerank → boost query and a symptom → tool decision table. Teases Part 2.

~2,050 words. Every snippet was checked against the current Python client; the alpha-sweep, both fusion modes, and the Boost call ran against a local Weaviate 1.38.

Open before publish (tracked as inline TODOs — opening as draft)

  • Hero image (./img/hero.png) + restore the image: frontmatter line
  • Boost API GA status — Preview in 1.38 today; confirm it's GA and stamp the exact version, or reframe the section with a preview caveat
  • Set the real publish date (currently a placeholder)
  • Link Part 2 ("Clean result sets: dedupe, diversify, and explain") once it publishes
  • Final human review

Part 2 to follow as a separate PR.

Part 1 of a 2-part "Search result quality & ordering" series: hybrid alpha, fusion, reranking, and the Boost API on a DocChunk RAG example. Snippets checked against the current Python client and a local Weaviate. Open publish TODOs (hero image, Boost GA/version stamp, publish date, Part 2 link) tracked inline; opening as draft.

@orca-security-eu orca-security-eu Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Orca Security Scan Summary

Status Check Issues by priority
Passed Passed Infrastructure as Code high 0   medium 0   low 0   info 0 View in Orca
Passed Passed SAST high 0   medium 0   low 0   info 0 View in Orca
Passed Passed Secrets high 0   medium 0   low 0   info 0 View in Orca
Passed Passed Vulnerabilities high 0   medium 0   low 0   info 0 View in Orca

Address review of the ranking post: concrete RAG opening, question/keyword headings, three Mermaid diagrams (pipeline, hybrid fusion, over-fetch flow), inline jargon definitions, an faq block, and the primary keyword "hybrid search ranking" in title/description/headings/slug. Code snippets and the load-bearing facts are unchanged; Boost GA/version TODOs preserved.
@g-despot g-despot changed the title Blog (draft): Search result quality Part 1 — Ranking Blog (draft): Hybrid search ranking — Part 1 of 2 Jul 7, 2026
@g-despot

g-despot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

Revised after review (2nd commit). Changes: concrete RAG failure as the opening hook; question/keyword-framed headings; three Mermaid diagrams (retrieval→ranking→presentation pipeline, hybrid fusion, over-fetch→rerank→boost flow); inline definitions for jargon (cross-encoder, bi-encoder, RRF, min-max normalization, over-fetch); an faq block (FAQPage JSON-LD); primary keyword "hybrid search ranking" in title/description/slug/headings. Code snippets and all load-bearing facts are unchanged; Boost GA/version TODOs preserved. Still a draft — see the open checklist above (hero image, Boost GA confirmation, publish date, Part 2 link).

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