msokolov opened a new issue, #15996: URL: https://github.com/apache/lucene/issues/15996
### Description This class exposes a bunch of new capabilities, but they aren't adequately documented. In order to make use of the skipper, you need a mental model of the skip list data structure and the implicit assumptions that are being made by this class. Some things I found out that weren't clear at first: 1. Level 0 is the "top" level with the largest blocks; higher numbered levels represent successively nested sub-blocks. 2. The skipper only really works with fields that are primary index sort keys (I think?). What happens if you try to use the skipper with non-sorted fields? Can you still read block level statistics? Maybe - but how does skipping function in that case? 3. advance(docId) is forward-only, but what are the expectations around `advance(minValue, maxValue)`? Is it possible to reverse using this API? I can try to improve the docs, but my understanding is only superficial, and I don't want to add to the confusion, so for now I'm just asking questions :) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
