Localization

1. You are here:
2. Handbook
3. Marketing
4. Localization

Maintained by:

Introduction

This page contains guidelines for localization at GitLab. This page is maintained by the Global Content team.

Overview

GitLab is a global company that does business around the world. In order to best serve our global customers, we localize our content and campaigns into native languages.

Current State

Our current localization capablities are limited due to resources and bandwidth. Currently, we are focused on translating content that aligns to our P0 countries. Additionally, we are enabling our field marketing teams to get lighweight translations that don't require internal development or design resources.

Internal Reviews

To ensure translated content makes contextual and technical sense, we have internal native language speakers review the content. Internal reviewers are expected to review content for accuracy and quality and identify small mistakes made by the translator. Internal reviewers are not expected to copyedit or rewrite documents. If the quailty of a translated document is poor and needs to be written, the reviewer should stop reading and let the requestor know that the translation is not usable and provide a reason why. The requestor should provide this feedback to the translator.

Guidelines for reviewers

1. Identify copy mistakes.
2. Identify areas where the context did not translate well and needs more attention.
3. Identify words or phrases that should not be translated.
4. If by the third second page it is clear that the translation is too poor to be used, stop reading and let the requestor know that translation is not usable and should be resumbitted.

Process for requesting a review

1. Open a translation review request
2. Complete all requested fields in the issue.
3. Content DRI to assign the reviewer. Reviewers are rotated in the order listed below.

Process for requesting a review via Smartling

For some languages, a review step is built within the translation process in Smartling. We have internal reviewers that are trained on Smartling to review and send back to the translators if there are any issues.

Languages that the Smartling step is enabled for:

1. German
2. Russian
3. Japanese
4. Korean

Internal reviewers for these languages that will review via Smartling:

Please follow the below process for requesting a review but please do so at the same time of opening the Smartling job:

1. Submit job in Smartling
2. Directly after, create a review issue and tag all the reviewers of language.
3. Reviewers have 24-48 hours to claim the job.
4. If it’s not claimed, campaign manager has right to assign the job to one of the reviewers on the Gitlab issue.
5. Reviewer needs to claim the job on Smartling. Once it’s ready to review, they will get an email notification alert them that their job is ready to review
6. Once reviewed, if ready to publish, please publish the job and update on the Gitlab review issue to let the campaign manager- it would be great if they could also let the campaign manager know the quality of the translation.

Priority Countries

Annually we prioritize countries that we believe offer the most opportunity for GitLab. A listing of those countries and our expected level of investment are tracked in an internal document called: Priority Country Analysis.

Our current localization capabilities are limited due to resources and bandwidth. Currently, we are focused on translating content that aligns to our integrated campaign strategy. Additionally, we are enabling our field marketing teams to get lightweight translations that don't require internal development or design resources.

Tools & Capabilities

Translating content for campaigns

Localized campaigns currently follow the the integrated campaign process. The Content Marketing team is responsible for content localization for integrated campaigns. Content marketers are responsible for campaigns that fall within their subject area domain:

After a content asset or webpage has been translated, be sure to add it to the Localization Resources spreadsheet. If edit access, isn't available, send the content addition to @bmatturro to update.

Translated URL structure

All translated pages live in a sub-folder dedicated to a specific language. These sub-folders use [ISO 639-1 codes] (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). For example, German pages live in the /de/ sub-folder.

hreflang tagging

Search engines use the hreflang tag to determine a canonical version for translated pages. We'll use hreflang on our translated pages.

hreflang tags start with declaration <link rel="alternate", adds URL href={{url}}, and ends with hreflang={{language ISO}}

Example of a hreflang tag for a URL translated to German.

<link rel="alternate" href="https://about.gitlab.com/de/warum/nutze-continuous-integration-fuer-schnelleres-bauen-und-testen/" hreflang="de" />

The canonical version of our site will the United States English version on about.gitlab.com. We need to add all versions of a page under the page title and link to each one with the appropriate language noted. Google provides this example:

<head>
 <title>Widgets, Inc</title>
  <link rel="alternate" hreflang="en-gb"
       href="http://en-gb.example.com/page.html" />
  <link rel="alternate" hreflang="en-us"
       href="http://en-us.example.com/page.html" />
  <link rel="alternate" hreflang="en"
       href="http://en.example.com/page.html" />
  <link rel="alternate" hreflang="de"
       href="http://de.example.com/page.html" />
 <link rel="alternate" hreflang="x-default"
       href="http://www.example.com/" />
</head>

It's important to note we need to declare the default page from our repository as the canonical version to avoid penalities across Google properties.

Aleyda Solis maintains a great tool to build hreflang tags we can use for reference as well.