updated readme to provide some api goals/explainations