Unverified Commit 9fe8560e authored by per1234's avatar per1234 Committed by GitHub

[skip changelog] Add readme for localization data (#1837)

Arduino CLI has been translated to 12 languages.

The localization process follows the following steps:

1. An English language source string is defined in the Arduino CLI codebase
2. The source string is pushed to Transifex
3. Community translators localize the string
4. The localization data is pulled into the Arduino CLI repository
5. The localization data is incorporated into the Arduino CLI distribution

Experience with maintenance of the Arduino IDE 1.x project indicates that the data files generated at step (4) can
appear to be the appropriate place to make edits for casual contributors not familiar with the project's sophisticated
internationalization infrastructure.

Since those files are generated by automated systems, any edits made there would only be overwritten, so it is important
to clearly communicate the correct way to make enhancements or corrections to these strings. This is accomplished by a
local readme file most likely to be seen by those working in the folder containing these files, which supplements the
existing information about translation in the project's CONTRIBUTING.md.
parent c7564727
# Localization data
This folder contains the [localization](https://wikipedia.org/wiki/Language_localisation) data for **Arduino CLI**.
❗ These files are automatically generated and so can not be edited directly. If you wish to modify the contents, do it
at the source:
- **en.po** - edit the string in the source code file indicated by the comment above it <br /> e.g., a comment
`#: commands/upload/upload.go:615` indicates the source string is at line 615 of the file
[`commands/upload/upload.go`](../../commands/upload/upload.go)
- **All other files** - the localization is done on **Transifex**: <br />
https://explore.transifex.com/arduino-1/arduino-cli/
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment