updated test and api documentation