improve API documentation