All article sources are in src/content. The base content is in English under the en directory. Add translations by following the same structure with either a two letter or composite language code: e.g. es, pt-br.

Our supported languages include: Arabic (AR), German (DE), Spanish (ES), French (FR), Hebrew (HE), Bahasa Indonesia (ID), Italian (IT), Japanese (JA), Korean (KO), Dutch (NL), Polish (PL), Portuguese (PT-BR), Russian (RU), Turkish (TR), Chinese Traditional (ZH-TW) and Chinese Simplified (ZH-CN).

Adding a translation

  1. Find the article in the original source language
  2. Create the root language code in src/content if it does not exist for the language you are translating. For example create src/content/es for Spanish.
  3. Create the article in the same directory hierarchy but under this new directory.
  4. Translate the article
  5. Give yourself credit by adding your details to the contributors file (src/data/_contributors.yaml)
  6. Add your name as described below with - translator property.


All of our content is Creative Commons 3.0. Contributions and translations are very much appreciated, however you must sign our Contributor License Agreement for the code to be pulled back in to the repository.


We want to make sure that you get the credit for the articles that you translate.

Add your details to src/data/_contributors.yaml and add - translator to the role attribute. We use this information to populate our contributors page and also to attach your name to each article. For example:

    given: Paul
    family: Kinlan
    name: Google
      unit: Developer Relations
  country: UK
    - author
    - engineer
    - translator
  google: +PaulKinlan
  twitter: paul_kinlan
    en: "Paul is a Developer Advocate"