Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs Language #150

Open
kalpovskii opened this issue Jun 1, 2022 · 7 comments
Open

Docs Language #150

kalpovskii opened this issue Jun 1, 2022 · 7 comments
Labels
enhancement New feature or request

Comments

@kalpovskii
Copy link

Can I translate the docs into my native language? Or you wish It to be only in English?

@kalpovskii kalpovskii added the enhancement New feature or request label Jun 1, 2022
@Messhias
Copy link
Collaborator

Messhias commented Jun 1, 2022

Can I translate the docs into my native language? Or do you wish It to be only in English?

You can translate since you keep English as well and update the documentation too.

@kalpovskii
Copy link
Author

You can translate since you keep English as well and update the documentation too.

I'm new to open source. What should I do first?

@Messhias
Copy link
Collaborator

Messhias commented Jun 1, 2022

You can translate since you keep English as well and update the documentation too.

I'm new to open source. What should I do first?

Don't worry, we'll help you.

1 - Fork the project to your GitHub.
2 - From the main branch create another with a suggestive name, e.g: feature/add-doc-language-<here the language that you're doing it>
3 - After all the work is done, you create a merge request from your repo to ours.

Sounds complicated, but it isn't, the GitHub UI gives you all the support to do that, but if you have any question while you're doing that you can post here and we'll help you out with that.

@kalpovskii
Copy link
Author

You can translate since you keep English as well and update the documentation too.

I'm new to open source. What should I do first?

Don't worry, we'll help you.

1 - Fork the project to your GitHub. 2 - From the main branch create another with a suggestive name, e.g: feature/add-doc-language-<here the language that you're doing it> 3 - After all the work is done, you create a merge request from your repo to ours.

Sounds complicated, but it isn't, the GitHub UI gives you all the support to do that, but if you have any question while you're doing that you can post here and we'll help you out with that.

OK. Thank you for the answer.

@leon0399
Copy link
Member

leon0399 commented Jun 1, 2022

Hi, @twistn1! You can contact me if you need some support in Russian

@Messhias I would vote against accepting PR adding docs on other language. By accepting PR we also accept responsibility to maintain these changes relevant. Supporting documentation in multiple languages might difficult without team of active members, who can take this responsibility. As only russian-speaking member, I cannot take this responsibility, at least for now, because of IRL difficulties caused by ongoing situation

@kalpovskii
Copy link
Author

Hi, @twistn1! You can contact me if you need some support in Russian

@Messhias I would vote against accepting PR adding docs on other language. By accepting PR we also accept responsibility to maintain these changes relevant. Supporting documentation in multiple languages might difficult without team of active members, who can take this responsibility. As only russian-speaking member, I cannot take this responsibility, at least for now, because of IRL difficulties caused by ongoing situation

@leon0399 Thank you. I will contact you if needed.
Despite if you accepting or not, I will translate it for my russian-speaking colleagues anyways. I understand your concerns, but I hope my translation could help the russian-speaking community.

@Messhias
Copy link
Collaborator

Messhias commented Jun 1, 2022

Hi, @twistn1! You can contact me if you need some support in Russian

@Messhias I would vote against accepting PR adding docs in another language. By accepting PR we also accept responsibility to maintain these changes relevantly. Supporting documentation in multiple languages might be difficult without a team of active members, who can take this responsibility. As the only Russian-speaking member, I cannot take this responsibility, at least for now, because of IRL difficulties caused by the ongoing situation

I believe we don't have to take this responsibility since someone is want to do that, our only responsibility is to keep it as English, I'm a Brazil Portuguese speaker native as well and for me sometimes is hard to work with something without my native language and I understand why he wants to do that, and we're open source, so anyone can contribute, if the documentation in any other XPTO language being outdated or something like that, just go the English as well.

I don't see how this could harm the repository.

But I believe we need to vote on that to decide.

Is there's way to do some votation here on GitHub?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

3 participants