Translating The Turing Way#


  • There are no prerequisites for this chapter and no knowledge in GitHub or programming is assumed.


This chapter covers the motivation for translating The Turing Way to other languages, some technical aspects about localisation and internationalisation, and the workflows to start a new language translation or contributing to existing ones.

This illustration shows how global accessibility is reached through translation. A diverse team of three people are writing their contribution in each of the pieces of a puzzle. The pieces complete parallel arrows around the Globe. The arrows are labeled "Constantly updated" because this process is continuous.

Fig. 162 Illustration of translation as a way to reach global accessibility. The Turing Way project illustration by Scriberia. Used under a CC-BY 4.0 licence. DOI: 10.5281/zenodo.3332807#


Translation is a key step for internationalisation of The Turing Way and any efforts in this regard are really welcome. Having translated versions of The Turing Way can open the channels for communicating between communities of practice around the world. Translation is part of community building!

Potential translators are members of The Turing Way community who would like to use the materials for teaching and communication and new members that are not yet part of The Turing Way community but can contribute.


You do not need to be fluent in English to contribute to the translations, you only need to speak your own language.

The workflows for translation can become confusing at some times and many translation efforts go unfinished for many reasons. Our aim is to provide clear documentation so any potential contributor is able to participate. Any new member of the community should be able to step in, enter in touch with other members of the translation teams for their languages, and start helping to use the documentation.

In the next few pages, you will learn how open source projects are translated using translation management systems (TMS), how we organise our translation and localisation efforts inside The Turing Way, and how you can get started in translating The Turing Way using Crowdin.