improve API documentation.