update readme with new API style and minor updates