Hi everyone,

I am a new member at this forum. I am super excited to get started with contributing to D lang. D lang is a great language with so much potential.

I am currently pursuing a Master's degree in Artificial Intelligence and I aspire to be a part of GSoC this year. I came across the D lang repository from the previous year organisations list on the GSoC website. I have always had a dream of contributing to a programming language. How cool is that right?!!

Anyway, GSoC aside, I think I have already found the first contribution that I would like to make to D Lang. It is to add another language to tour.dlang.com. The language that I want to add is Urdu. Urdu is an asian language and originates from the subcontinent of India. It is also spoken by the majority of people in Pakistan and other countries surrounding India. It is a vibrant language spoken by over 100 million people in the world.

Making the tutorials for tour.dlang.com available in Urdu will have a great impact and outreach as many people from the subcontinent aspire to be engineers and programmers. Making the tutorials available in their native tongue is a good idea.

I would really appreciate it if someone can list out the steps to take in this regard.

Thanks in advance!

On Friday, 7 February 2020 at 11:52:17 UTC, Mir H. S. Quadri wrote:
> Hi everyone,
>
> I am a new member at this forum. I am super excited to get started with contributing to D lang. D lang is a great language with so much potential.
>
> Making the tutorials for tour.dlang.com available in Urdu will have a great impact and outreach as many people from the subcontinent aspire to be engineers and programmers. Making the tutorials available in their native tongue is a good idea.
>

Sounds Awesome! Welcome!

On Friday, 7 February 2020 at 11:52:17 UTC, Mir H. S. Quadri wrote:
> Hi everyone,
>
> I am a new member at this forum. I am super excited to get started with contributing to D lang. D lang is a great language with so much potential.
>
> I am currently pursuing a Master's degree in Artificial Intelligence and I aspire to be a part of GSoC this year. I came across the D lang repository from the previous year organisations list on the GSoC website. I have always had a dream of contributing to a programming language. How cool is that right?!!
>
> Anyway, GSoC aside, I think I have already found the first contribution that I would like to make to D Lang. It is to add another language to tour.dlang.com. The language that I want to add is Urdu. Urdu is an asian language and originates from the subcontinent of India. It is also spoken by the majority of people in Pakistan and other countries surrounding India. It is a vibrant language spoken by over 100 million people in the world.
>
> Making the tutorials for tour.dlang.com available in Urdu will have a great impact and outreach as many people from the subcontinent aspire to be engineers and programmers. Making the tutorials available in their native tongue is a good idea.
>
> I would really appreciate it if someone can list out the steps to take in this regard.
>
> Thanks in advance!

Hello and welcome aboard!

I agree that a great way to start contributing is to translate the tour in another language for all the reasons you mentioned.

I am one of the maintainers of the dlang-tour project and I went ahead and created a repository to help you get started:
https://github.com/dlang-tour/urdu

For now it's just a copy-paste of the English version. The process is as follows:
1. Clone the repository [1] locally.
2. Follow the instructions from language repo [1] and the core [2] on how to run the tour locally, so you could preview your changes.
3. Translate file-by-file. Open a pull-request on GitHub for each translated chapter (file). It's best to start with a single translated file, so you can get feedback on the process as soon as possible. After you get the hang of it I will grant you write permissions to the language repo [1] so you can continue working without our supervision.
4. As soon as you feel there's enough of the repo translated to be presentable, ping us either by opening an issue on the core repo [2] or by opening a thread here on the forums and we will open a pull request to add your language repo as a git submodule (e.g. like this: [3]). At this point your language would be available to read online at this URL:
https://tour.dlang.org/tour/ur (ur is the ISO 639-1 language abbreviation).

I hope this helps!

Good luck with GSOC!


[1]: https://github.com/dlang-tour/urdu
[2]: https://github.com/dlang-tour/core
[3]: https://github.com/dlang-tour/core/commit/ba0a817a1affa5066300a82a6314d056f77f97ee#diff-608039ed72b4ef76d9bf3af5305d07e8
[4]: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

On Friday, 7 February 2020 at 17:38:01 UTC, Petar Kirov [ZombineDev] wrote:
> I am one of the maintainers of the dlang-tour project and I went ahead and created a repository to help you get started:
> https://github.com/dlang-tour/urdu
>
> [...]

Hi,

Thank you so much for making the repository and detailing the steps for me. I will get started right away. Thanks again!