sdmx-twg / sdmx-json

This repository is used for maintaining the SDMX-JSON message specifications.
54 stars 20 forks source link

Weird bit of text at the end of `dataType` definition #138

Open hoehrmann opened 8 months ago

hoehrmann commented 8 months ago

In https://github.com/sdmx-twg/sdmx-json/blob/71fe5eaa9fcd29e3c15f2f0216a19b9b650b1dbd/data-message/docs/1-sdmx-json-field-guide.md#format

If used then the component values will use instead of id and name:

  • if minOccurs and maxOccurs are equal to 1: the value property,
  • otherwise: the values property.

I do not understand what this refers to. The dataType property is always used because it has a default value. I am not sure how component values "use" id and name, or what it would mean to use value instead of id and name. For what purpose?

This text part of the specification needs to be better formatted, and rephrased.

(In doubt, please handle this as a public review comment on SDMX 3.1 once the comment period begins.)