CAL-1045 Improve API documentation