add scan function to return all users or all matching a criteria
update docs