sdmx-json icon indicating copy to clipboard operation
sdmx-json copied to clipboard

`annotation.value` vs. `annotation.text`

Open hoehrmann opened this issue 10 months ago • 0 comments

There is insufficient guidance in https://github.com/sdmx-twg/sdmx-json/blob/71fe5eaa9fcd29e3c15f2f0216a19b9b650b1dbd/data-message/docs/1-sdmx-json-field-guide.md regarding these properties:

  • value - String optional. A non-localised value text of the annotation.
  • text - String optional. A human-readable (best-language-match) text of the annotation.
  • texts - Object optional. A list of human-readable localised texts (see names) of the annotation.

The SDMX 3.0 Information Model specification also does not shine light on why this has value and text. Consider the case of only a single language in the system. Would the same text be in all three properties? Should reading applications treat them with any kind of preference if multiple values are available? Should generating applications simply ignore the value property? Or does value serve some other purpose, like, value could be for machine-readable code, while text is for humans.

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

hoehrmann avatar Mar 27 '24 00:03 hoehrmann