update readme and notes