tidy docs for query overloads