better doc of api
clean up