# How can I help regarding internationalisation and translation of documentation?

**URL:** <https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962>\
**Category:** documentation\
**Created:** [December 5, 2018, 1:44pm UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962 "2018-12-05T13:44:14Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![psychoslave](https://avatars.discourse-cdn.com/v4/letter/p/5f9b8f/32.png) [@psychoslave](https://internals.rust-lang.org/u/psychoslave)\
**Post date:** [December 5, 2018, 1:44pm UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/1 "2018-12-05T13:44:15Z")

</div>

Hello everybody.

Following [Centril](https://users.rust-lang.org/u/Centril) recommandation, I [forward this post from users](https://users.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/22857)

# Forwarded post

Following an advice of @TomP I would like to dedicate some resources in “_building a localizing dictionary of Rust error message templates together with their translations. And as a next phase from that maybe create a postprocessor for piped Rust compiler output, which could provide a localized translation of those error messages whose templates were in the dictionary (with any other error messages left untranslated)_”.

Also I would be more than happy to help translate official documentation and website, but looking at the page [contribute translations](https://www.rust-lang.org/en-US/contribute-translations.html), there is not much guidance.

On a side note, I would recommend to change “Rust is universal” to something more engaging like “Rust strive to embrace cultural diversity, help us to foster it universally”.

Kind regards

---

<div class="post-metadata">

**Author:** ![VitalyR](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/vitalyr/32/8395_2.png) [@VitalyR](https://internals.rust-lang.org/u/VitalyR)\
**Post date:** [December 5, 2018, 3:36pm UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/2 "2018-12-05T15:36:11Z")

</div>

According to [this issue](https://github.com/rust-lang/beta.rust-lang.org/issues/96), the official team haven’t decided to choose which method for i18n/l10n. I commented there but no reply.

---

<div class="post-metadata">

**Author:** ![steveklabnik](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/steveklabnik/32/4524_2.png) [@steveklabnik](https://internals.rust-lang.org/u/steveklabnik)\
**Post date:** [December 5, 2018, 6:48pm UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/3 "2018-12-05T18:48:44Z")

</div>

Hey there!

We’re still working on getting the proper infrastructure set up here. [The book has the ability to be translated,](https://github.com/rust-lang/book#translations) but the website and standard library docs are an ongoing thing.

---

<div class="post-metadata">

**Author:** ![Tom-Phinney](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/tom-phinney/32/3299_2.png) [@Tom-Phinney](https://internals.rust-lang.org/u/Tom-Phinney)\
**Post date:** [December 5, 2018, 8:16pm UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/4 "2018-12-05T20:16:07Z")

</div>

In addition to translating the book and textual portions of the website and standard library, as mentioned in the prior post, my proposal that the OP cited was to translate the more complex error message patterns produced by rustc. That suggestion was based on item 3 of [two](https://users.rust-lang.org/t/the-internationalization-of-rust-itself/14545/56) [posts](https://users.rust-lang.org/t/the-internationalization-of-rust-itself/14545/66) of mine on u.r-l.o.

As of last May, rustc had about 5000 error message templates. Translating even 1/3 of those would probably be a substantial help to new ESL (English as a Second Language) Rustaceans, particularly for errors related to traits and associated types, lifetimes, and the borrow checker.

---

<div class="post-metadata">

**Author:** ![psychoslave](https://avatars.discourse-cdn.com/v4/letter/p/5f9b8f/32.png) [@psychoslave](https://internals.rust-lang.org/u/psychoslave)\
**Post date:** [December 6, 2018, 10:58am UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/5 "2018-12-06T10:58:43Z")

</div>

Ho, great, I think I’ll start with a translation of the book then. 🙂

---

<div class="post-metadata">

**Author:** ![psychoslave](https://avatars.discourse-cdn.com/v4/letter/p/5f9b8f/32.png) [@psychoslave](https://internals.rust-lang.org/u/psychoslave)\
**Post date:** [December 8, 2018, 6:24pm UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/6 "2018-12-08T18:24:31Z")

</div>

For reference, the issue [Esperanto translation](https://github.com/rust-lang/book/issues/1665) was launched as a next step to this discussion.

---

<div class="post-metadata">

**Author:** ![Uther](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/uther/32/6225_2.png) [@Uther](https://internals.rust-lang.org/u/Uther)\
**Post date:** [December 10, 2018, 7:34am UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/7 "2018-12-10T07:34:12Z")

</div>

Is there a plan on how to translate the standard library since it is based on Rustdoc ?

Some time ago, I made a Pre-RFC to [make rustdoc handle translations](https://internals.rust-lang.org/t/pre-rfc-localization-for-rustdoc/3190), but I did not get much feedback. I may be interested to work on that if it can help with you plan.

---

<div class="post-metadata">

**Author:** ![steveklabnik](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/steveklabnik/32/4524_2.png) [@steveklabnik](https://internals.rust-lang.org/u/steveklabnik)\
**Post date:** [December 10, 2018, 6:32pm UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/8 "2018-12-10T18:32:48Z")

</div>

There is no real plan at this time. Working on one would be great!

---

<div class="post-metadata">

**Author:** ![psychoslave](https://avatars.discourse-cdn.com/v4/letter/p/5f9b8f/32.png) [@psychoslave](https://internals.rust-lang.org/u/psychoslave)\
**Post date:** [December 13, 2018, 1:12pm UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/9 "2018-12-13T13:12:22Z")

</div>

Hi Uther. Thank you the proposal. I guess that surely it would greatly help the internationalisation if you would take care of integrating translation facilities into rustdoc. Translating the standard library seems indeed a good step, as it both will deal with most common components developers will have to deal with and cover already decently large enough base on which leverage most further translations where needed.

Cheers

---

<div class="post-metadata">

**Author:** ![system](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/system/32/14092_2.png) [@system](https://internals.rust-lang.org/u/system)\
**Post date:** [March 25, 2019, 8:31am UTC](https://internals.rust-lang.org/t/how-can-i-help-regarding-internationalisation-and-translation-of-documentation/8962/10 "2019-03-25T08:31:16Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.
