update readme with notes