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

Multilanguage support for docs? #13

Closed
GetLocalPlayer opened this issue Dec 12, 2018 · 10 comments
Closed

Multilanguage support for docs? #13

GetLocalPlayer opened this issue Dec 12, 2018 · 10 comments

Comments

@GetLocalPlayer
Copy link

No description provided.

@GetLocalPlayer GetLocalPlayer changed the title Multilanguage support for wurstlang.org? Multilanguage support for docs? Dec 12, 2018
@Frotty
Copy link
Member

Frotty commented Dec 12, 2018

Sure, should be somewhat easily possible using this https://github.com/Anthony-Gaudino/jekyll-multiple-languages-plugin
But then we will need translators for all pages.

@GetLocalPlayer
Copy link
Author

GetLocalPlayer commented Dec 12, 2018

Isn't it better to have an opportunity to translate the docs even if the translation isn't finished yet since the docs are updated often?

@peq
Copy link
Contributor

peq commented Dec 12, 2018

I think we can just add a warning box to the pages with incomplete translations. The box can contain a link to the English version and a plea to contribute.

@Frotty
Copy link
Member

Frotty commented Dec 12, 2018

Isn't it better to have an opportunity to translate the docs even if the translation isn't finished yet since the docs are updated often?

Well, which docs are you referring to? The standard library docs don't even exist in english yet :D
But yeah, for those it could work. Other parts like manual just being incomplete doesn't work imho.
Is there a language you would like to maintain?

@GetLocalPlayer
Copy link
Author

The standard library docs don't even exist in english yet :D

Should it not be generated automatically? From stdlib itself.

Other parts like manual just being incomplete doesn't work imho.

At least it would be useful to let users know that Wurst is open to translation. On the main page or as a part of "Best of the Wurst" or something.

Is there a language you would like to maintain?

Russian.

@Frotty
Copy link
Member

Frotty commented Dec 13, 2018

Should it not be generated automatically? From stdlib itself

hotdoc does generate some doc, but it's not in a proper format rn.
In any case it makes sense have to more detailed, informal pages to go over packages and show best practices examples next to it, since those wouldn't fit inside the package as hotdoc and it's quite common practice among frameworks.

At least it would be useful to let users know that Wurst is open to translation. On the main page or as a part of "Best of the Wurst" or something.

sure. but since we can hardly validate usefulness and correctness of foreign translations, we would probably need maintainers for those languages to review possible PRs

@GetLocalPlayer
Copy link
Author

sure. but since we can hardly validate usefulness and correctness of foreign translations, we would probably need maintainers for those languages to review possible PRs

You have to start somewhere anyway. Any possible discussion here is always more than nothing. As far as I know, at least Chinese developers would be interested.

@Frotty
Copy link
Member

Frotty commented Dec 13, 2018

at least Chinese developers would be interested.

we offered this to the chinese ppl, but they decided to instead copy the page http://wurst.wow8.org/

@Frotty
Copy link
Member

Frotty commented Jun 4, 2019

@GetLocalPlayer So what's the status?
Are you still interested in this?

@GetLocalPlayer
Copy link
Author

No.

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

No branches or pull requests

3 participants