adding some api documentation