improve api documentation in readme