Expand the log message for case when we reached the threshold of hits…

…, add some code level comments

Signed-off-by: Martin Gaievski <[email protected]>

src/main/java/org/opensearch/neuralsearch/query/HybridQueryScorer.java

@@ -189,7 +189,12 @@ public int docID() {
      */
     public float[] hybridScores() throws IOException {
         float[] scores = new float[numSubqueries];
+         //retrieves sub-matches using DisjunctionDisiScorer's two-phase iteration process.
+         //while the two-phase iterator can efficiently skip blocks of document IDs during matching,
+         //the DisiWrapper (obtained from subScorersPQ.topList()) ensures sequential document ID iteration.
+         //this is necessary for maintaining correct scoring order.
         DisiWrapper topList = getSubMatches();
+
         for (HybridDisiWrapper disiWrapper = (HybridDisiWrapper) topList; disiWrapper != null; disiWrapper =
             (HybridDisiWrapper) disiWrapper.next) {
             // check if this doc has match in the subQuery. If not, add score as 0.0 and continue

src/main/java/org/opensearch/neuralsearch/search/collector/HybridTopScoreDocCollector.java

@@ -116,7 +116,11 @@ public void collect(int doc) throws IOException {
                         continue;
                     }
                     if (hitsThresholdChecker.isThresholdReached() && totalHitsRelation == TotalHits.Relation.EQUAL_TO) {
-                        log.info("reached hits threshold check");
+                        log.info(
+                            "hit count threshold reached: total hits={}, threshold={}, action=updating_results",
+                            totalHits,
+                            hitsThresholdChecker.getTotalHitsThreshold()
+                        );
                         totalHitsRelation = TotalHits.Relation.GREATER_THAN_OR_EQUAL_TO;
                     }
                     collectedHitsPerSubQuery[i]++;