From b3db43bfb5f4ae355d94c33040a07bed615f2ca5 Mon Sep 17 00:00:00 2001
From: Paul Masurel <paul.masurel@datadoghq.com>
Date: Mon, 5 Jan 2026 11:15:45 +0100
Subject: [PATCH] Explicit doc for the meaning of intersection_priority

---
 src/query/weight.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/query/weight.rs b/src/query/weight.rs
index c6ec9f3d3..4d664ffd3 100644
--- a/src/query/weight.rs
+++ b/src/query/weight.rs
@@ -146,6 +146,10 @@ pub trait Weight: Send + Sync + 'static {
 
     /// Returns a priority number used to sort weights when running an
     /// intersection.
+    ///
+    /// Tweaking this value only impacts performance.
+    /// A higher priority means that the `.scorer()` will be more likely to be evaluated
+    /// after the sibling weights, and be passed a higher `seek_doc` value as a result.
     fn intersection_priority(&self) -> u32 {
         20u32
     }