sdmx-json
sdmx-json copied to clipboard
`annotation.value` vs. `annotation.text`
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.)