Please change only the locale content in the en-US
directory. The other directories are changed using Pontoon.
Here are the most important rules:
- If you change the string in a way that changes the meaning, you need to change the string key as well. If that doesn't change the meaning (for example, if that's a typo fix), then the string key can stay the same. You can read the dedicated documentation if you want to know more.
- If you include a variable, make sure to add a comment explaining it.
- If the context for a string isn't clear (for example, this is a short string whose content doesn't give an indication about where it's used), please add a comment explaining it too. You can read the dedicated documentation to see more examples of when a comment is necessary.
The page about localization best practices for web developers gives a lot of good guidance to write excellent strings.
Please use Pontoon to update languages other than en-US.
If a pull request updates those, we'll ask you to revert these changes.