i18next / i18next-gitbook

165 stars 172 forks source link

Documentation contradicts itself concerning support of json format #165

Closed jonathan-wiens closed 3 years ago

jonathan-wiens commented 3 years ago

🐛 Bug Report

This page documents what JSON format is supported by i18next. It doesn't contain arrays. This page documents that arrays are supported within the JSON for keys.

To Reproduce

Not relevant, since it's a documentation error.

Expected behavior

The JSON format page includes arrays as supported format.

Your Environment

Not relevant, since it's a documentation error.

jamuhl commented 3 years ago

The JSON format page does not include the array -> as it is no linguistic part of the format -> simple strings, plurals and context are linguistically needed to form proper translations

Array and objects are only a technical representation of multiple strings

jonathan-wiens commented 3 years ago

Thanks for the answer. I think it would still be helpful to include arrays as an example in the JSON format, even if it has no linguistic impact. When I read "JSON format" I would understand it to be the exact technical JSON format supported by i18next, nothing more. Reading it as is gives the impression that arrays are not supported, technically.

jamuhl commented 3 years ago

I extended the page: https://www.i18next.com/misc/json-format#i-18-next-json-v3