CAL-1045 improve api doc