improved some api documentations