update readme based on new interface, add additional examples