Update: see readme here

This thread will contain all info related to translating the State of CSS and State of JS surveys going forward.

Getting Started

The YAML files to translate live in this current repo, which contains our API:

• https://github.com/StateOfJS/state-of-js-graphql-results-api/tree/master/src/i18n

IMPORTANT: also check that there aren't any existing PRs for the language you want to translate first!

Getting Credit

Every translator will be credited on any site that makes use of the translations, starting with the survey-taking app. You can add your name here if it's not already there.

• https://github.com/StateOfJS/state-of-js-graphql-results-api/blob/master/src/i18n/locales.yml

Translation API

You can get extra data such as the completion percentage for a locale or the untranslated strings via our API, available at:

• https://graphiql.stateofjs.com/

Here is a sample query:

query GetLocaleData {
  locale(localeId: "ru-RU") {
    completion
    totalCount
    translatedCount
    translators
    untranslatedKeys
  }
}

Translation Files

Surveys App

These strings are related to the app that you use to fill out the actual survey.

• surveys.yml
• accounts.yml
• state_of_js_2020_survey.yml

Results App

These strings only appear in the static site that displays the survey results and stats.

• results.yml
• state_of_css_2020.yml
• state_of_js_2020.yml

Both

These strings appear in both.

• common.yml
• state_of_css.yml
• state_of_js.yml

Other

• homepage.yml

Joining Translation Teams

It's recommended you join the translation team for the language you want to translate.

Previous Translations

You may also want to take a look at previous year's translations if that helps:

• State of JS 2019
• State of CSS 2019