update readme with assumptions