Information Hub for Linguists

2022-05-24 Updated known issues and clarified update forum behavior

2022-05-17 Added information on the new currency format variants (-alphaNextToNumber and -noCurrency), and information on the date-time combining pattern -atTime variant.

2022-05-16 Added pointers to the new Person Names Guide

2022-05-09 Added information to What's new in this cycle

Summary

This page and the pages in this section provide guidelines for translation of CLDR strings.

  • Please read this page completely before starting, and visit this page (Information hub for linguists) every other day, and check for news at the top. Also check the Known Issues for any new problems.

  • The information on this page will be updated at least weekly on Wednesdays if there are changes. New information will be highlighted by blue italicized text. Please bookmark it!

New data changes:

    • Coverage, Phase 2, primarily the modern coverage additions of language names, script names, etc.

    • New -alphaNextToNumber and -noCurrency variants of the currency formats, see Number and currency patterns

    • New -atTime variant of the date-time combining pattern, see Date/Time Patterns

    • Person Names

    • New emoji

    • Locale coverage level upgrades:

      • ⇒ Basic: bgc, bho, raj

      • ⇒ Moderate: xh

      • ⇒ Modern: hi_Latn, pcm, ha, ig, yo, nn

    • Unicode 15.0 additions (script names, collation data (Han), etc.)

Current Survey Tool stage: v42 Submission

Thank you for contributing to CLDR v42!

The Survey Tool is now open for Submission on 18 May 2022 for data to be included in CLDR v42.

Please refer to the Milestone Schedule for the full v42 release schedule.

Prerequisites


  1. Know Data stability expectations

  2. Know topics under @Getting Started to ensure familiarity on what you may encounter working in the Survey Tool.

  3. @General translation guides are the customary expectations for all the vetting work.

  4. Disconnect error. If you see a persistent Loading error with a disconnect message or other odd behavior, please empty your cache.

  5. Survey Tool email notification may be going to your spam folder. Check your spam folder regularly.

Notation

💡 — marks important translation tips

bolded text — marks items that need special attention

blue italicized text — marks latest updates

What's new in this cycle


  • If you are new to CLDR contribution, please read the prerequisites above first.

  • If you have contributed to CLDR in the past, below is the information that's new or changed since the last release.

Progress Widget

There is a new style for the progress widget that shows your voting progress on the page in the upper right corner of the Survey Tool next to the Info Panel toggle. You will see details of your progress when you hover over the widget, including what progress is being measured, and the total number of items remaining for you to vote on in that category. Your progress is measured based on the coverage level you have set, so make sure that it is set correctly.

Note: The total progress widget is currently only visible when the dashboard is open.

Page progress

Progress bar shows progress of items on page for your coverage level.

Overall progress

Progress bar shows progress of items overall for your coverage level.

Update to forum post responses

In order to reduce confusion there are no longer buttons to 'Agree' or 'Disagree' with a forum post (earlier people mistakenly thought that clicking the agree button would also change their vote).

If you change your vote an automatic posting indicating agreement will be added to the forum as before.

Examples

The examples have been augmented, especially for Minimal pairs. An example with an ❌ shows a case where the pattern has an inappropriate placeholder substituted. That example should be ungrammatical; if it is grammatical, then either the translated unit or the minimal pair pattern itself is incorrect. The example will show in the Info Panel, and also if you hover over the item.

Recent Changes

  • New data see below

  • Updated known issues

Survey Tool

Translation quality

The following are areas where we have seen data quality issues or those that need your attention more carefully.

  • Avoiding voting for English

    • For items that do not work in your language, please don't simply use English. Find a solution that works for your language. For example, if your language doesn't have a concept of "quarters", use a translation that describes the concept "three-month period" rather than “quarter-of-a-year”.

  • Dealing with “Same as code” errors:

    • Since v37, if you voted for the Code, a Same as Code error will raise.

    • When translating codes for items such as languages, regions, scripts, and keys, it is normally an error to select the code itself as the translated name (such as “en” as the translated name for code “en” English), except for some specific cases including certain script codes (for example, code “Thai” is also the name for script Thai in several languages).

    • If the error appears under Typography, you can ignore. [CLDR-13552]

  • Bidi example limitations [CLDR-10674]. If you are working with a bi-directional languages, be aware of the Right-to-Left and Neutral context. Survey Tool only shows examples with a strong RL context, and we have been issues where vetters removed the ALM bidi marks or modify the patterns without considering the neutral context. Please be cautious of changing the bi-di formatting data.

  • Handling Display name menu variants

Translation guides

If you are new to CLDR, use the @Getting Started topics to get started and review the left Table of Contents under Translation Guides.

Updated sections

The site has been been migrated from the classic to new Google Sites. If you have any difficulty accessing a page following the migration please report the issue to your PM.

Known Issues

Last updated: 2022-05-24

Please review this list before getting started to avoid creating duplicate tickets. This list will be updated as fixes are made available in Survey Tool Production. If you hit a problem, please file a ticket.


  1. CLDR-15662 LocaleCompletion (third) Meter percent too high

  2. Expanded section in left navigation panel flickers if clicked [CLDR-14750]

  3. Same name collision error. If two items differ only by upper/lower case or punctuation, it still counts as a collision. However, currently, only one of them is flagged as an error. [CLDR-11274]

  4. Images for the plain symbols. Non-emoji such as €, √, », ¹, §, ... do not have images in the info pane. [CLDR-13477]

    • Workaround: Look at the Code column; unlike the new emoji, your browser should display them there.

  1. Careful with square brackets. Brackets "[ ]" under Alphabetic information are used to group the alphabetic information and they are not part of the data. [CLDR-13180]

    • Workaround: Please ignore the [ and ] characters in the Alphabetic information and do not try to update the data to exclude the [ and ].

Resolved Issues

Last updated: 2022-05-09

The following list of previously listed on the Known Issues have now been resolved and fixed:

  1. Unclear error message when not logged into Survey Tool. [CLDR-14845]

  2. “Multiple Languages” confusing. [CLDR-15222]

  3. Issues importing your votes. Error message: "Status 500 Internal Server Error; URL:..." [CLDR-15178]

  4. Unclear to vetters why they can't edit locales that are not open or only open for specific paths [CLDR-15224]