Skip to content

Commit 09cdfa8

Browse files
Clarify limited vendor config capability (#45)
* Clarify limited vendor config capability, as noted in mozmeao/springfield#818 (comment) * Copy updates for further explanation/clarity Co-authored-by: Jan Brasna <1784648+janbrasna@users.noreply.github.com> * Update list numbers --------- Co-authored-by: Jan Brasna <1784648+janbrasna@users.noreply.github.com>
1 parent 5cd7cbd commit 09cdfa8

1 file changed

Lines changed: 9 additions & 7 deletions

File tree

docs/l10n/configuration.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,8 @@ def about_view(request):
120120

121121
In order for a Fluent file to be extracted through automation and sent out for localization, it must first be configured to go through one or more distinct pipelines. This is controlled via a set of configuration files:
122122

123-
- [Vendor](https://github.com/mozilla/bedrock/blob/main/l10n/configs/vendor.toml), locales translated by an agency, and paid for by Marketing (locales covered by staff are also included in this group).
123+
- [Vendor](https://github.com/mozilla/bedrock/blob/main/l10n/configs/vendor.toml), locales translated by an agency, and paid for by Marketing (locales covered by staff are also included in this group).
124+
- **Note:** Automation always submits all vendor locales at once for paid translation. Exclusions in the configs currently do not have any effect.
124125
- [Pontoon](https://github.com/mozilla/bedrock/blob/main/l10n/configs/pontoon.toml), locales translated by Mozilla contributors.
125126
- [Special templates](https://github.com/mozilla/bedrock/blob/main/l10n/configs/special-templates.toml), for locales with dedicated templates that don't go through the localization process (not currently used).
126127

@@ -141,13 +142,14 @@ You can read more about configuration files in the [L10n Project Configuration](
141142

142143
Using a combination of vendor and pontoon configuration offers a flexible but specific set of options to choose from when it comes to defining an l10n strategy for a page. The available choices are:
143144

144-
1. Staff locales.
145-
2. Staff + select vendor locales.
146-
3. Staff + all vendor locales.
147-
4. Staff + vendor + pontoon.
148-
5. All pontoon locales (for non-marketing content only).
145+
1. No localization exposed (e.g. by only limiting to `en-US/*.ftl` file locally, instead of source `en/*.ftl` sent for translation).
146+
2. All vendor locales.
147+
3. All vendor locales + subset of pontoon locales.
148+
4. All vendor locales + all pontoon locales.
149149

150-
When choosing an option, it's important to consider that vendor locales have a cost associated with them, and pontoon leans on the goodwill of our volunteer community. Typically, only non-marketing content should go through Pontoon for all locales. Everything that is marketing related should feature one of the staff/vendor/pontoon configurations.
150+
When choosing an option, it's important to consider that vendor locales have a cost associated with them, and pontoon leans on the goodwill of our volunteer community. Exposing strings that only end up used in two or three vendor locales costs the same as having them translated in all the paid-for languages. Similarly, exposing a string to several dozen volunteer languages in case such content will never be shown in these locales (e.g. elements for pages with limited locale enablement) triggers unnecessary work from our contributor communities.
151+
152+
See docs on [CMS localisation](../cms/l10n.md) for Wagtail-specific integrations.
151153

152154
## Fluent File Activation
153155

0 commit comments

Comments
 (0)