improved API documentation