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

x/website: Translate "ref/spec" to other languages #43545

Open
skanehira opened this issue Jan 6, 2021 · 12 comments
Open

x/website: Translate "ref/spec" to other languages #43545

skanehira opened this issue Jan 6, 2021 · 12 comments
Labels
help wanted NeedsFix The path to resolution is known, but the work has not been done.
Milestone

Comments

@skanehira
Copy link
Contributor

I propose that translate "ref/spec" to other languages like a "Tour of Go".
I think it will help people who cannot read English.

@gopherbot gopherbot added this to the Unreleased milestone Jan 6, 2021
@ALTree
Copy link
Member

ALTree commented Jan 6, 2021

Note that only the English translation of the tour is directly maintained by the Go Project. All the other translations were created and deployed by native speakers, we only link to them.

Obviously people are free to translate the language specification too, and host the translations somewhere. But everything that the Go Project directly controls is currently in English.

@skanehira
Copy link
Contributor Author

skanehira commented Jan 6, 2021

All the other translations were created and deployed by native speakers, we only link to them.

Oh, I'm sorry, I misunderstood.
I thought Go Project has been translating.

If I translate "ref/spec", should I make a PR to link to it?

@ALTree
Copy link
Member

ALTree commented Jan 6, 2021

The Tour is meant to be a very basic and understandable introduction to Go, and it's useful to have it translated so that beginners without a strong command of the English language can learn it. On the other hand, the language specification is a very dry, formal, and technical document that is mostly used by people who want to implement an alternative compiler, I think. It's not a tutorial or a learning document, and in fact we discourage people from trying to learn Go by reading it. For this reason I think that translating it (and then linking the translations on https://golang.org/ref/spec) would not be particularly useful.

cc @griesemer for a decision (mostly about linking it, obviously you're still free to translate the language spec if you wish so).

@ALTree ALTree added the NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. label Jan 6, 2021
@skanehira
Copy link
Contributor Author

skanehira commented Jan 6, 2021

On the other hand, the language specification is a very dry, formal, and technical document that is mostly used by people who want to implement an alternative compiler, I think.

Yeah, agree.
But I think some people would like lean more details for specification through document like Me.
Translated document will help them.

@griesemer
Copy link
Contributor

The language spec is not intended as an introduction to programming; and it's clearly more "dense" than an introduction to programming in Go. But it's still a lot easier to read than typical language specs since we have taken great care to keep formalism at a minimum and the document compact. It is definitively intended to be consulted for any language questions; it's not "just" for compiler writers. Finally, for people with enough experience, reading the language spec is a very quick way to get up to speed, simply because it's short.

I would support good translations as long as each translation makes it clear that the final reference is the original English version. This should avoid any disputes due to slightly incorrect translations.

I don't think this is something the Go team needs to do. While we do have native expertise in English, German, Italian, Spanish, and probably a few more languages in the team and perhaps could review translations as needed, doing a good translation job requires a significant commitment. It also requires that such documents are kept up-to-date. This seems like a good opportunity for community members who want to help spread Go beyond English speakers.

@skanehira
Copy link
Contributor Author

skanehira commented Jan 6, 2021

I would support good translations as long as each translation makes it clear that the final reference is the original English version. This should avoid any disputes due to slightly incorrect translations.

Agreed.

I don't think this is something the Go team needs to do.

I think so too.
This is not something that can do only by the Go team.
Community members would can do this.

While we do have native expertise in English, German, Italian, Spanish, and probably a few more languages in the team and perhaps could review translations as needed, doing a good translation job requires a significant commitment. It also requires that such documents are kept up-to-date.

I don't think the Go specifications will change much unless the version is up.
Translating work will be hard at first time, but maintain will be not hard in my imagination.

This seems like a good opportunity for community members who want to help spread Go beyond English speakers.

My finally goal is this.
I don't know English so much, but I want to read and understand more Go specification.
I think there have many people like me in the world.

@griesemer griesemer added help wanted and removed NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. labels Jan 6, 2021
@skanehira
Copy link
Contributor Author

If this propose is approved, I'll try translate English to Japanese.

@ianlancetaylor
Copy link
Contributor

@skanehira If you are interested in doing that, go ahead. We don't have to approve it. Thanks.

@skanehira
Copy link
Contributor Author

skanehira commented Jan 7, 2021

@ianlancetaylor
Thanks :)
I'll try it.

@skanehira
Copy link
Contributor Author

skanehira commented Jan 8, 2021

@ianlancetaylor
Should I translate this file directly?
Or other files?

https://github.com/golang/go/blob/master/doc/go_spec.html

@griesemer
Copy link
Contributor

@skanehira Yes, this is the spec: https://github.com/golang/go/blob/master/doc/go_spec.html . We update the date at the top when we make changes which should make it easy to see if you need to make changes in the translated document. Thanks.

@toothrot toothrot added the NeedsFix The path to resolution is known, but the work has not been done. label Jan 8, 2021
@skanehira
Copy link
Contributor Author

@griesemer

We update the date at the top when we make changes which should make it easy to see if you need to make changes in the translated document.

OK, Thanks :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted NeedsFix The path to resolution is known, but the work has not been done.
Projects
None yet
Development

No branches or pull requests

6 participants