README is outdated for several API calls

For example, the find call now returns a generator so the example as given doesn't work.