The dlang-tour translations need you

Seb via Digitalmars-d digitalmars-d at puremagic.com
Mon May 22 07:52:43 PDT 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


More information about the Digitalmars-d mailing list