#2 some more docs for select related code