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:
-
Create a Crowdin account:
- Sign up at the Crowdin workspace.
- Start translating one or more languages.
-
Active participation:
- You’ll receive notifications about new strings that need translation.
- Keep up to date with translations and participate in discussions in the Dev > Translations category on Discourse.
-
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 Dev > Translations if there isn’t one for your language.
Proofreading
Reviewers ensure translations are accurate and maintain a consistent style. To become a proofreader:
-
Request proofreader permissions:
- Reply to this topic and provide your language along with your Crowdin username.
- We do not grant proofreading permissions for the following languages because they are managed by a translation agency:
- Arabic
- Chinese Simplified
- Dutch
- Finnish
- French
- German
- Italian
- Japanese
- Portuguese (Brazilian)
- Russian
- Spanish
- Turkish
-
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.