Add translator documentation for all en.yml strings - #447
Conversation
Generated by 🚫 Danger |
Complete config/locales/qqq.yml with descriptions for all 3,074 translatable strings, covering context, variable placeholders, and usage notes to assist translators. Co-authored-by: Amazon Q Developer <amazon-q-developer@amazon.com>
|
Thanks for looking into this. Do you know why the upstream openstreetmap-website project doesn’t have a qqq.yml? Is that just an oversight, or should we be excluding it from both projects? I think openstreetmap-website has historically assumed that they could use comments in en.yml to communicate nuances to translators in some cases, but obviously /qqq is a more robust mechanism for that. The departure from openstreetmap-website is significant because we’re also considering redoing this fork to rely on an override file instead of repeating the entire base localization: OpenHistoricalMap/issues#735 (comment). In that case, we would maintain a separate qqq.yml in the same directory as our override files, coexisting with any qqq.yml copied over from upstream (but that file doesn’t exist yet). |
Complete
config/locales/qqq.ymlwith descriptions for all 3,074 translatable strings, covering context, variable placeholders, and usage notes to assist translators.Description
qqq.ymlis a special TranslateWiki file that provides documentation hints for translators. It is not a translation itself and is not managed by TranslateWiki — it lives in the source repo and is read by TranslateWiki to show context to translators working on any of the supported languages.Previously the file was largely incomplete. This PR adds descriptions for all 3,074 translatable strings in
en.yml, covering:%{name},{{name}}) with explanations of what each containsHow has this been tested?
Verified with a Ruby script that all 3,074
en.ymlleaf keys have a correspondingqqq.ymlentry:EN leaf keys: 3074
QQQ leaf keys: 3239
Missing: 0
The higher QQQ count reflects plural form documentation entries (
one/other/fewetc.) that are documented separately.