added some api documentation