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