Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
website: add support for languages other than English #21666
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
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:
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.)
@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.
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.
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