function generators contain api-specific references, should be defined in the api files