In API sections like field_data where VariableDescriptor has become an alternative to string, make sure that VariableDescriptor is first class:
- allowed values are avaialble as
VariableDescriptors, not just strings
- where practical, error and diagnostic information refers to
VariableDescriptors rather than strings