more inline API documentation