API documentation clarification, fixes.