just a pinch more API documentation