Localization Checklist¶
Template Verification¶
- No hardcoded English strings
- All Fluent references are valid
- Run
./manage.py l10n_updateto make sure you have the most recent Fluent files
- Run
- Unused IDs are removed
String Conventions¶
- Proper organization with subheadings
- Correct brand references
- Explanatory comments for idioms and variables
- Appropriate handling of HTML attributes and link text
ID Conventions¶
- Lowercase hyphenated naming with filename prefixes
- Version control for altered strings
- Removal notes for fallbacks including date
New File Requirements¶
- Fluent files belong in
/l10n/en/ - The top of the file should include the URL of the page on the dev server
- Configured in
pontoon.toml - Connected to templates or views
Style Standards¶
- Lowercase "web" and "internet"
- Em dashes have spaces on either side
- Sentence case for headings
- Use "sign in" / "sign out" (not login/out)
See also: