docs for awaiting and filterBy