Details
Description
It was brought to my attention that the javadoc on Scan#setBatch(int) does not inform the user that calling this method has the implicit side-effect that the user may see partial {{Result}}s.
While the side-effect isn't necessarily surprising for developers who know how it's implemented, but for API users, this might be a very jarring implication.
We should update the documentation on Scan#setBatch(int) to inform users that they may see partial results if they call this method (and perhaps refer them to the size-based Scan#setMaxResultSize(long) too).