Thread overview
The dlang-tour translations need you
May 22, 2017
Seb
May 22, 2017
Stanislav Blinov
May 27, 2017
Quentin Ladeveze
May 28, 2017
juanjux
May 22, 2017
Hi all,

this is just a quick update from the Dlang Tour maintainers (there will be a bigger one next month when we finally get the menu and navigation UX issue addressed).

For now, I want to highlight another fact: the Dlang Tour is most likely the first "in-depth" point of contact for newcomers (if you think this isn't true due to missing visibility or why it shouldn't be, please let me know).
In any case, this means that Andrei's famous first five minutes will be spent to a great extent on this tour. This means that whenever you have time, you can help the D community just by going through the pages and clicking the "Edit" button on the right and/or opening issues at the regarding repo (https://github.com/dlang-tour/english)

For more general ideas (UI, features, ...), you can ping us at the base repo:

https://github.com/stonemaster/dlang-tour/issues

Translations
------------

While in some countries, English is taught for many years in school, in others it's a barrier for people who want to learn D. I think Ali and his Turkish D-Community have proven that having excellent documentation in the native language can make a huge difference.
A couple of months ago we modified the DLang Tour, s.t. every language is a submodule which can be separately maintained. They can be found here:

http://tour.dlang.org/tour/en/welcome/languages
https://github.com/dlang-tour

Most of the translation "projects" have unfortunately stopped, so any help to revive them is very welcome.
The entire tour is written in Markdown, so it's even possible to edit a language purely with the GH UI and without knowing anything about git or programming.
However, if you do want to run it locally, that's rather easy as well, e.g.:

> dub fetch dlang-tour
> git clone https://github.com/dlang-tour/english
> cd english
> dub run dlang-tour -- --lang-dir .

I am just going to highlight the three best translations, but obviously much more people have helped to get the Dlang Tour to the stage where it's now and the virtual thanks goes to all of them.

Ukrainian
---------

- Completely translated
- https://tour.dlang.org/tour/uk/welcome/welcome-to-d
- Huge thanks to @eresid (Eugene) and @ikod

Japanese
--------

- @kotet is doing a lot of hard work, so even sole reviewing would help
- https://github.com/dlang-tour/japanese/pulls
- Huge thanks to @kotet, @majiang, @simdnyan, @alphaKAI

Russian
-------

- Welcome & Basic chapter completely translated
- https://tour.dlang.org/tour/ru/welcome/welcome-to-d
- Huge thanks to @El-Lin, @dmi7ry, @9il, @Dicebot, @DmitryOlshansky
May 22, 2017
On Monday, 22 May 2017 at 14:52:43 UTC, Seb wrote:

> Russian
> -------
>
> - Welcome & Basic chapter completely translated
> - https://tour.dlang.org/tour/ru/welcome/welcome-to-d
> - Huge thanks to @El-Lin, @dmi7ry, @9il, @Dicebot, @DmitryOlshansky

If nobody's working on that already, I'll take the "Gems" chapter. And go by chapter unless someone else also participates.
May 27, 2017
On Monday, 22 May 2017 at 14:52:43 UTC, Seb wrote:
...
> Most of the translation "projects" have unfortunately stopped, so any help to revive them is very welcome.
...

Challenge accepted. I already translated the welcome section in french, and I am currently working on the basics section (https://github.com/aceawan/french/ if you want to know my progression and/or to review my translation)


May 28, 2017
I will start to work on the Spanish version.

On Monday, 22 May 2017 at 14:52:43 UTC, Seb wrote:
> Hi all,
>
> this is just a quick update from the Dlang Tour maintainers (there will be a bigger one next month when we finally get the menu and navigation UX issue addressed).
>
> For now, I want to highlight another fact: the Dlang Tour is most likely the first "in-depth" point of contact for newcomers (if you think this isn't true due to missing visibility or why it shouldn't be, please let me know).
> In any case, this means that Andrei's famous first five minutes will be spent to a great extent on this tour. This means that whenever you have time, you can help the D community just by going through the pages and clicking the "Edit" button on the right and/or opening issues at the regarding repo (https://github.com/dlang-tour/english)
>
> For more general ideas (UI, features, ...), you can ping us at the base repo:
>
> https://github.com/stonemaster/dlang-tour/issues
>
> Translations
> ------------
>
> While in some countries, English is taught for many years in school, in others it's a barrier for people who want to learn D. I think Ali and his Turkish D-Community have proven that having excellent documentation in the native language can make a huge difference.
> A couple of months ago we modified the DLang Tour, s.t. every language is a submodule which can be separately maintained. They can be found here:
>
> http://tour.dlang.org/tour/en/welcome/languages
> https://github.com/dlang-tour
>
> Most of the translation "projects" have unfortunately stopped, so any help to revive them is very welcome.
> The entire tour is written in Markdown, so it's even possible to edit a language purely with the GH UI and without knowing anything about git or programming.
> However, if you do want to run it locally, that's rather easy as well, e.g.:
>
>> dub fetch dlang-tour
>> git clone https://github.com/dlang-tour/english
>> cd english
>> dub run dlang-tour -- --lang-dir .
>
> I am just going to highlight the three best translations, but obviously much more people have helped to get the Dlang Tour to the stage where it's now and the virtual thanks goes to all of them.
>
> Ukrainian
> ---------
>
> - Completely translated
> - https://tour.dlang.org/tour/uk/welcome/welcome-to-d
> - Huge thanks to @eresid (Eugene) and @ikod
>
> Japanese
> --------
>
> - @kotet is doing a lot of hard work, so even sole reviewing would help
> - https://github.com/dlang-tour/japanese/pulls
> - Huge thanks to @kotet, @majiang, @simdnyan, @alphaKAI
>
> Russian
> -------
>
> - Welcome & Basic chapter completely translated
> - https://tour.dlang.org/tour/ru/welcome/welcome-to-d
> - Huge thanks to @El-Lin, @dmi7ry, @9il, @Dicebot, @DmitryOlshansky