query builder: paginate method, small documentation enhancements