update readme to match @rvirding's new API
fix some of the types
 Merge new readme