Contributing translations to Discourse

[Discourse]

This document provides a guide on how to contribute translations to the Discourse platform using Crowdin.

Required user level: Anyone can contribute translations

Translating Discourse into different languages is essential for its global adoption. Contributing as a translator or proofreader is greatly appreciated and helps in making Discourse accessible to a broader audience.

Summary

This guide covers:

• Translating Discourse using Crowdin.
• Becoming a proofreader to ensure translation quality.
• Best practices for contributing translations.

Translating

To start translating Discourse, follow these steps:

1. Create a Crowdin account:

   • Sign up at the Crowdin workspace.
   • Start translating one or more languages.

2. Active participation:

   • You’ll receive notifications about new strings that need translation.
   • Keep up to date with translations and participate in discussions in the translations category on Discourse.

3. Automatic integration:

   • Contributions are automatically integrated into Discourse repositories weekly.

For more information on how Crowdin works, visit the Crowdin Online Editor Guide.

It’s always a good idea to start a discussion with your fellow translators before making large or radical changes to existing translations. Please create a new topic in translations if there isn’t one for your language.

Proofreading

Reviewers ensure translations are accurate and maintain a consistent style. To become a proofreader:

1. Request proofreader permissions:

   • Reply to this topic and provide your language along with your Crowdin username.
   • If you were a translator or reviewer on Transifex, mention your Transifex username too.

2. Quality assurance:

   • We limit the number of reviewers to a maximum of two per language to maintain quality. If you have a good reason for an exception, please start a discussion in this topic. Consistency and accuracy are critical for maintaining high translation standards.

Additional resources

• Crowdin Workspace
• Crowdin Online Editor Guide
• Discussions in #dev:translations on Discourse

Last edited by @hugh 2024-06-11T04:24:29Z

Last checked by @hugh 2024-06-11T04:24:33Z

Check document

Perform check on document:

[Dev_Kaique (Kaique)]

[Português Brasileiro - PT]
Crowdin username: advokaiquedias

[gerhard (Gerhard Schlager)]

Hi @Dev_Kaique,
thanks for wanting to help with proofreading. Proofreading of Portuguese (Brazil) is handled by a translation agency, so we aren’t accepting any other proofreaders. But, if you see a problem with an already reviewed translation, feel free to downvote the current translation and suggest a better one on Crowdin. The translators will consider them the next time they work on the translations.

[tig3 (Tig)]

Hi, could you please make me a proofreader in Crowdin.

Language: Armenian
Username in both Transifex and Crowdin is: tig3

Thanks

P.S. old discussion for Transifex

ETA for language request review in Transifex - Armenian language request

Hi everyone, me and my team wanted to start the translation for Armenian language, I did a request in Transifex a few days ago, but no notifications so far, so wanted to touch base about that. Thanks

[gerhard (Gerhard Schlager)]

@tig3 I added you as a proofreader for Armenian. Currently, only for the “discourse” project, not plugins and theme components. Updating all those projects is a manual process, so you’ll get assigned to them the next time we update the Crowdin workflow for all those projects.