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

website: add support for languages other than English #21666

Open
ericlagergren opened this issue Aug 28, 2017 · 5 comments

Comments

@ericlagergren
Copy link
Contributor

commented Aug 28, 2017

Right now the docs are only in English. There's some support for languages other than English, but the wiki page is merely a footnote.

Other projects—like React—are attempting this as well. Not only does it give newcomers a (somewhat) easy way to contribute to Go, it also makes Go a more welcoming and inclusive place for non-English speakers. Obviously the English version would remain the "master" version of the docs.

Ideally, golang.org would respect the Accept-Language header or support some sort of en/, fr/, etc. URL path option.

I'm not sure how much of a proposal this needs to be, but it's something I'm willing to put further thought into if needed. (It's not a language change or anything, so I didn't write out a full proposal.)

Projects with their docs and/or websites in multiple languages:

  • React
  • Rust
  • Python
  • Java (sorta)
  • PHP
  • JavaScript (via MDN)
  • Perl (third party)
  • Ruby
  • Babel
  • LaTeX
  • Scala (like how Go currently does it, but more uniform)
  • ...
@cznic

This comment has been minimized.

Copy link
Contributor

commented Aug 28, 2017

With full respect to everyone's choice of which language to use and when, in my experience using any other language than English to study programming/CS and/or learn from the documentation makes that programmer less capable on the long run - and vice versa. (I'm not a native English speaker.)

@ericlagergren

This comment has been minimized.

Copy link
Contributor Author

commented Aug 28, 2017

@cznic that's a good point. As a native English speaker I don't have much experience learning to program in a non-native language. Personally, I've noticed that it can be more difficult to "concretely" learn things in a non-native language. But I've also had the luxury of having most everything I needed in my native language.

That's neither here nor there, though. I don't really believe it's Go's job to require its users to adhere to what we (general "we") believe to be best practices that are unrelated to the language itself.

@dominikh

This comment has been minimized.

Copy link
Member

commented Aug 28, 2017

How will the Go team review contributions in other languages? And who guarantees that they're kept in sync with changes/additions to the standard library?

@ericlagergren

This comment has been minimized.

Copy link
Contributor Author

commented Aug 28, 2017

@dominikh

How will the Go team review contributions in other languages?

In this case, unless the Go team member speaks that language, they'll have to sanity check it (Google translate, etc.) Ideally, you'd have a community member double-check the additions.

And who guarantees that they're kept in sync with changes/additions to the standard library?

IMO the best way to start would be to start on the more static parts: golang.org/, golang.org/doc/, golang.org/doc/contribute.html, etc. If that's too difficult to keep in sync or the whole thing flounders, it can be scrapped.

Alternatively (or additionally), a simple disclaimer can be put at the top of translated pages. (Like I mentioned before, English is the 'master' version.)

As an example of what the React project is doing: facebook/react#8063

@ianlancetaylor ianlancetaylor added this to the Unplanned milestone Mar 29, 2018

@ianlancetaylor

This comment has been minimized.

Copy link
Contributor

commented Mar 29, 2018

CC @spf13

@ALTree ALTree added NeedsDecision and removed NeedsFix labels Sep 22, 2018

@bcmills bcmills changed the title docs: add support for languages other than English website: add support for languages other than English Apr 9, 2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
6 participants
You can’t perform that action at this time.