2018-09-26 12:30:08 +00:00
# Merging translations from Crowdin
Crowdin automatically syncs the `gitlab.pot` file presenting newly
added translations to the community of translators.
At the same time, it creates a merge request to merge all newly added
2019-01-31 02:45:38 +00:00
& approved translations. Find the [merge request created by
2019-09-18 14:02:45 +00:00
`gitlab-crowdin-bot` ](https://gitlab.com/gitlab-org/gitlab/merge_requests?scope=all& utf8=%E2%9C%93& state=opened& author_username=gitlab-crowdin-bot)
2019-10-22 15:06:06 +00:00
to see new and merged merge requests.
2018-09-26 12:30:08 +00:00
## Validation
By default Crowdin commits translations with `[skip ci]` in the commit
message. This is done to avoid a bunch of pipelines being run. Before
merging translations, make sure to trigger a pipeline to validate
translations, we have static analysis validating things Crowdin
2019-09-27 12:06:07 +00:00
doesn't do. Create a new pipeline at `https://gitlab.com/gitlab-org/gitlab/pipelines/new`
(need Developer access permissions) for the `master-i18n` branch.
2018-09-26 12:30:08 +00:00
If there are validation errors, the easiest solution is to disapprove
the offending string in Crowdin, leaving a comment with what is
required to fix the offense. There is an
2019-10-22 15:06:06 +00:00
[issue ](https://gitlab.com/gitlab-org/gitlab/issues/23256 )
2018-09-26 12:30:08 +00:00
suggesting to automate this process. Disapproving will exclude the
invalid translation, the merge request will be updated within a few
minutes.
It might be handy to pause the integration on the Crowdin side for a
little while so translations don't keep coming. This can be done by
clicking `Pause sync` on the [Crowdin integration settings
page](https://translate.gitlab.com/project/gitlab-ee/settings#integration).
When all failures are resolved, the translations need to be double
2019-09-18 14:02:45 +00:00
checked once more as discussed in [confidential issue ](../../user/project/issues/confidential_issues.md ) `https://gitlab.com/gitlab-org/gitlab-foss/issues/37850` .
2018-09-26 12:30:08 +00:00
## Merging translations
When all translations are found good and pipelines pass the
2019-10-22 15:06:06 +00:00
translations can be merged into the master branch. When merging the translations, make sure to check the `Remove
2018-09-26 12:30:08 +00:00
source branch` checkbox, so Crowdin recreates the `master-i18n` from
master after the new translation was merged.
We are discussing automating this entire process
2019-10-22 15:06:06 +00:00
[here ](https://gitlab.com/gitlab-org/gitlab/issues/19896 ).
2018-09-26 12:30:08 +00:00
## Recreate the merge request
Crowdin creates a new merge request as soon as the old one is closed
or merged. But it won't recreate the `master-i18n` branch every
time. To force Crowdin to recreate the branch, close any [open merge
2019-09-18 14:02:45 +00:00
request](https://gitlab.com/gitlab-org/gitlab/merge_requests?scope=all& utf8=%E2%9C%93& state=opened& author_username=gitlab-crowdin-bot)
2018-09-26 12:30:08 +00:00
and delete the
2019-09-27 12:06:07 +00:00
[`master-18n` ](https://gitlab.com/gitlab-org/gitlab/-/branches/all?utf8=✓&search=master-i18n ).
2018-09-26 12:30:08 +00:00
This might be needed when the merge request contains failures that
have been fixed on master.