updated readme to cleanup api description a bit