update readme to document recent api changes